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This equipment generates and uses radio frequency 
energy and if not installed and used properly, that is, 
in strict accordance with the.manufacturer's instruc- 
tions, may cause interference to radio and television 
reception. It has been type tested and found to com- 
ply with the limits for a Class B computing device in 
accordance with the specifications in Subpart J of 
Part 15 of FCC Rules, which are designed to provide 
reasonable protection against such interference in a 
residential installation. However, there is no guaran- 
tee that interference will not occur in a particular 
installation. If this equipment does cause interference 
to radio or television reception, which can be deter- 
mined by turning the equipment off and on, the user 
is encouraged to try to correct the interference by one 
or more of the following measures: 


* reorient the receiving antenna 

relocate the computer with respect to the receiver 

* move the computer away from the receiver 

e plug the computer into a different outlet so that 
computer and receiver are on different branch 


If necessary, the user should consult the dealer or an 
experienced radio/television technician for additional 
suggestions. The user may find the following booklet 
prepared by the Federal Communications Commission 
helpful: ‘‘How to Identify and Resolve Radio-TV Inter- 
ference Problems’’. This booklet is available from the 
US Government Printing Office, Washington, DC 
20402, Stock No. 004-000-00345-4. 


WARNING: This equipment has been certified to 
comply with the limits for a Class B computing device, 
pursuant to Subpart J of Part 15 of FCC Rules. Only 
peripherals (computer input/output devices, termi- 
nals, printers, etc.) certified to comply with the Class 
B limits may be attached to this computer. Operation 
with non-certified peripherals is likely to result in 
interference to radio and TV reception. 


90-Day Limited Warranty 


Congratulations 
on the Purchase of Your 
Timex Sinclair Computer! 


We hope you'll take the time to read the owner’s manual. This will help you to use 
your Timex Sinclair Computer most effectively and with the greatest of pleasure. 


Your new Timex Sinclair Computer, incorporating the latest electronic technology, 
has been manufactured under stringent quality control standards. Yet, no matter 
how well designed and constructed, your computer may at some time require 
service. 


To assure that you enjoy the traditional satisfaction of owning a Timex product, 
Timex computer repair service offers: 


© 90-DAY LIMITED WARRANTY 

¢ LOW COST 12-MONTH SERVICE CONTRACT 
¢ FACTORY REPLACEMENT PARTS 

® RELIABLE REPAIRS 

¢ PROMPT RETURN OF YOUR COMPUTER 


The Timex Computer Club 


The Timex Computer Club is an exclusive group of Timex Sinclair Computer 
Owners. Membership in the Timex Computer Club will allow you to increase your 
enjoyment of your Timex Sinclair computer. As a member, you will receive regular 
early notice of Timex Computer Corporation technological advances, new hardware 
and software products, creative programming ideas and special products and soft- 
ware Offers. You will also be able to share computer ideas and achievements with 
other club members all over the country! For enrollment see card in back of book. 


NOTE: The 90-Day Limited Warranty on your Timex Sinclair Computer is in no 
way affected if you choose not to send us the Purchase Information Card. However, 
we must have the information to enroll you in the Timex Computer Club. 


90-Day Limited Warranty 


Basic Coverage: This Timex Sinclair Computer is warranted.to the owner for a 
period of 90 days from date of original purchase against defects in manufacture. 
This Limited Warranty is given by Timex Computer Corporation—not by the dealer 
from whom it was purchased. 


What Timex Will Do: If a defect in manufacture of the Computer is discovered 
within 90 days from date of original purchase, Timex Computer Corporation will, 
at its option, repair or replace the defective unit. 

What You Must Do: You must return the Computer, with sales receipt, indicating 
date of purchase, to Timex Product Service Center with a written explanation of the 
reason for the return. It is recommended that you include both cables, TV/Computer 
switch, and Power Plug with your shipment. 


Return your unit, postage pre-paid to: 


Timex Product Service Center 
PO. Box K 

7004 Murray Street 

Little Rock, AR 72203 


To protect against in-transit loss, we recommend you insure your Computer. 


Limitations: 

THE ABOVE REMEDY IS EXCLUSIVE. TIMEX COMPUTER CORPORATION 
LIMITS THE DURATION OF ANY WARRANTY IMPLIED BY STATE LAW, 
INCLUDING THE IMPLIED WARRANTY OF MERCHANTABILITY, TO 90 DAYS 
FROM THE DATE OF ORIGINAL PURCHASE. TIMEX COMPUTER CORPORATION 
IS NOT LIABLE FOR ANY INCIDENTAL OR CONSEQUENTIAL DAMAGE. 

This warranty gives your specific legal rights, and you may also have other rights 
which vary from state to state. Some states do not allow limitations on how long an 
implied warranty lasts, or the exclusion of limitation of incidental or consequential 
damages, so the above limitations or exclusions may not apply to you. 


This warranty is void if the Computer has been tampered or ill-treated or if the 
defect is related to servicing not performed by us. 


Call 1-800-24-TIMEX from 8:00 AM to 8:30 PM 
ET* Monday through Friday for answers to 
computing problems and helpful hints. 

*Subject to change. 
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Introduction 

Welcome to the world of computing. Before you 
plug in your new Timex Sinclair 1500, please take 
a moment to consider these old sayings we just 
made up: 


1. You will enjoy computing. 

2. You will find it easy as well as enjoyable. 

3. You shouldn't be afraid of the computer. You 
are smarter than it is. 

4. You will make mistakes as you learn. You will 
learn from your mistakes. The computer will 
not laugh at you. 

5. Your mistakes will not do any harm to the 
computer. You can't break it by pushing the 
“wrong’’ button. 

6. You are about to take a giant step into the 
future. Everyone will soon be using computers 
in every part of their daily lives, and you will 
have a head start. 
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You Don’t Need to Learn Programming 
You do not need to know how to program a com- 
puter to use the T/S 1500, any more than you need 
to know how to do a tuneup in order to drive a car. 
You may want to learn to program —it is not dif- 
ficult and can be very enjoyable— but you can 
use the computer for the rest of your life without 
having to learn programming. 


A Computer Is a Tool 

A computer is a tool, like a hammer or saw — or 
perhaps like a food processor. Hammers and saws 
can generally do only one thing well. Food proces- 
sors can perform different operations, and normally 
you can “program” them by simply pushing the 
proper buttons. 


A computer is an information tool, and is the 
most versatile tool ever invented. Because it can 
do many things, it needs very detailed instruc- 
tions to perform any particular task. These instruc- 
tions are called programs, and someone has to 
write them— but not necessarily you. 


Many Programs are Available 

Once a program is written, it can be saved and 
used over and over again. Many of these programs 
are available for you to use on the T/S 1500. You 
can get some of them on tape cassettes and others 
in printed form. If a program is short, you may wish 
to type it in from a printed listing. Longer ones are 
easiest to load from a cassette tape. 


The many available programs for your Timex 
Sinclair 1500 include games, management tools 
for your home or business (like balance-sheet cal- 
culations, record-keeping, accounting/bookkeep- 
ing, taxes, personal or business inventories, etc.), 
creative and artistic activities. 


You can maintain athletic statistics, recipes, 
address or Christmas-card lists, prepare reports, 
learn and use mathematics, and do many other 


; 
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things. Because Timex Sinclair computers are 
among the world’s best-selling computers, new 
software (ready-to-run programs) is published 
every day. Your computer will someday be able to 
answer the telephone, place outgoing calls, bring 
you information from distant sources, monitor 
your burglar alarm, water your lawn and perform 
many other duties around the house. 


Use the Computer to Learn 

One of the most important uses of the 

Timex Sinclair computer is as an educational 
tool. Right now children are beginning to use 
computers in school, both in terms of learning 
about them and in using them to learn other 
subjects. Having a computer at home can help 
children in school whether or not the schools use 
computers. More and more educational 
programming is becoming available. 


The Timex Sinclair 1500 is an easy-to-use tool for 
the beginner, but it is a very sophisticated com- 
puter that many scientists and engineers use. As 
you become more expert in computing, you'll find 
that you won't easily outgrow your first computer. 


This Manual and Other Aids to Help You 
This manual will help you get started, and will 
give you the help you need to use the computer 
with ready-to-run programs and to do some ele- 
mentary programming of your own. There is a 
long and growing list of sources for more advanced 
information; check your Timex computer dealer, 
bookstore or library for the latest. 


Your dealer may be able to answer some of your 
questions, and will certainly have some books 
and other products to help you. 


Have fun as you get to know your Timex Sinclair 
1500 computer! 
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1 Your T/S 1500 


Chapter Preview This chapter shows you 
how to connect the T/S 
1500 to your TV and cas- 
sette recorder, and start 
using it right away. 


Here’s what you need to start using your 
Timex Sinclair 1500 computer, most of which 
came in the box with this manual: 


1. The computer itself. Only the size ofa 
small book, it packs the computing power of 
a room-sized machine of just a few years ago. 


You'll see three jack sockets on the back, 
marked 9V DC, MIC and EAR, and a larger 
socket marked TV. Also on the back of the 
computer is a slot, where you can attach 
“peripheral devices’ like the printer, the 
RAM pack for additional memory, etc. 


9vDC MIC EAR 2% 
C—O eee 


Rear view of computer 
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Television 


Computer 
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Transfer switch box 


ce meena 
TV cable 
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Dual audio cable 


Cassette recorder 


2. The power supply. It is a transformer that 


plugs into any standard wall socket (110 volts), 
with a cord that plugs into the computer’s 9V 
DC socket. The computer has no on/off switch: 
you turn it on by simply plugging it in with the 
power supply. 


. Your television set. You can use a color 


or a black-and-white set but, of course, the 
Timex Sinclair 1500 will display in black and 
white only. 


. Atransfer switch box, which enables you 


to switch between your TV antenna and the 
computer. If you already have a box that looks 
like this attached to your TV (from a video 
game console or another computer), you can 
just leave it there and keep this one as a spare. 


. Atelevision cable, several feet long, to 


connect the computer to your TV. 


. Adual audio cable, about a foot long, with 


miniature phone plugs at each end, to connect 
the T/S 1500 to your tape cassette recorder. 


. Your cassette recorder. You'!] need one 


that will accept the miniature plugs in its ear- 
phone and microphone sockets. (If you already 


have a recorder and it doesn't fit the plugs, try 


taking the recorder and the cables to your 
local electronics shop. You will probably be 
able to get very inexpensive adaptors rather 
than buying another cassette recorder.) 
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It is not necessary, but can be very helpful, if 
your recorder has a tape counter. You can then 
keep track of where on a tape a given program 
is located, making it easier to find them with- 
out having to wait for the computer to search 
an entire tape. 


Tape recorder counter 


Now that you have all the parts identified, you 
can begin to put the system together. (If you are 
going to try some programming-on your own, you 
can do without the recorder and skip Chapter 3 
after setting up; if you have a recorder and want 
to use some pre-recorded software, or save on 
tape some of your own programming, you'll want to 
study that chapter.) 


Power supply unit 


T/S 1500 Computer 


Cassette recorder 


See next page for instructions on setting up the 
computer. 


Chapter 1: How To Set Up 


Your T/S 1500 


Transfer switch box to 
VHF terminals on TV 


UHF/VHF matching 
transformer 


Television channels 


! Connect to antenna 


First, disconnect the VHF TV antenna wires from 
your television set (you can leave UHF wires alone). 


Connect the wires from the transfer switch box to 
the VHF terminals on your TV instead, and then 
connect the antenna wires to the screws marked 
TV on the switch box. 


Plug the connecting cable into the socket on the 
switch box and into the TV socket on the T/S 1500. 


If you have cable TV, or a 75-ohm antenna lead 
(the round wire, instead of the flat one), you’ll need 
to buy a “‘UHF/VHF matching transformer’’ (or it 
may be called something else; again, your local 
electronics store can advise you) for about three 
dollars. You may even have to contact your cable 
company if their wire goes directly into your 

set instead of screwing on to the terminal on 

the back. 


Next, turn on the TV. Set it to channel 2 or channel 
3, whichever one is not being used for broadcast- 
ing in your area. 


Then, plug the power supply into the wall and 
into the 9V DC socket on the computer. 


Computer to power supply 


If your TV is set to channel 3, press the number 3 
on the T/S 1500's keyboard. The Timex Sinclair 
1500 will automatically ‘‘broadcast’’ to channel 2 
unless ‘'3”’ is the first key pressed after it is turned 
on. If the 3 appears on the TV screen (it may or 
may not, depending on how quickly you press the 
key after plugging in the computer), press the 
ENTER key to remove it. 
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Turn the sound all the way down. You should now 
have a picture like this on your screen: 


The [fj in the lower left-hand corner of the screen 
is called the cursor, and means the T/S 1500 is 
ready for action. 


Note: The picture on your TV screen should be 
clear: if you are getting interference, try the fol- - 
lowing steps in order: 


1. Adjust the fine tuning control on the set, then 
try the brightness, contrast, and horizontal hold 
(horizontal is usually on the back of the set). 

2. Make sure your computer is set to the same 
channel as your TV. You can unplug the com- 
puter and then plug it in again, pressing the 3 
key or not as appropniate. 

3. Move the computer away from the TV set; or, 
if possible, place it lower than the set. 

4. Plug the computer into a different circuit from 

a the television set; usually outlets on opposite 

: walls are on different branch circuits. 

5. Consult an experienced radio/TV repairman; 
your set may need adjusting. 


Connect EAR to EAR 
If you are going to use a cassette recorder to load 
or to save programs, connect your recorder to the 
computer with the dual audio cable. 


Connect the Earphone socket of the recorder to 
the EAR socket on the computer in order to load 
a program from tape into the T/S 1500. 


Connect the microphone socket of the recorder to 
the computer's MIC socket to save programs 
you've written or changed by adding information. 


Notice that the plugs at the ends of the cables 
are color-coded, so that you can easily make the 
right connections. Just connect EAR to EAR with 
the same color plug at each end of the cable. 


Cassette recorder 


Now you're ready to use your Timex Sinclair 1500! 


= Moving Around 2 
the Keyboard 


Chapter Preview How the cursors — EJ, [J 
@. G —and SHIFT help 
you use all the functions 
on all the keys. We inves- 
tigate DELETE and the 
‘syntax error’’ marker, 
and learn how the left 
and right arrows work. 


You make the Timex Sinclair 1500 perform by 

pressing the keys on its keyboard. At first glance, 
this keyboard looks very complicated, but you'll 
quickly learn how to use it. 


(2) L*) ES ce C3 Be) CI i a ae 
ee 
eal Sal a Sal wk . Aa ee 
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If you know how to type, you'll notice that the 
largest labels on the keys—the letters and num- 
bers—are arranged just like a typewriter’s keys. 
‘(If you don’t type, you'll find that you won't have 
much trouble locating the keys anyway.) 


The good news — for typists and non-typists alike 
—is that you don’t have to type in the commands 
to the computer, letter by letter. Instead, you’ll 
find they are indicated as complete words on and 
around the keys. In many cases, the “‘keywords”’ 
are written above or near the key for the letter 
that the word begins with: notice, for example, 
the word PRINT above the P key, and POKE 
above the key next to it. Look at the keywords 
above the G, C, I, and R keys, too. 


All of the words and symbols on and around each 
key mean, of course, that each key can do many 
different things as you give instructions to the 
computer. 


What a key ‘‘means’”’ to the computer when you 
press it depends on two things: 


1. Which cursor is on the TV screen (remember 
the [J we saw in Chapter 1?), and 

2. Whether or not you use the SHIFT key while 
pressing another key. 
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Let's do a few things with the keyboard to see 
how to get all the different meanings from the 
keys. First, we'll ask you to do exactly as we tell 
you. Then, we’ll have a chance to experiment. 


The Ej Cursor... Words Above the Keys 
Set up and turn on the computer and television 
set as we did in the last chapter. You should now 
have the [J cursor in the lower left hand corner 
of the screen. 


Near the upper right hand corner of the keyboard 
is the P key. We'll call it— and other keys— by 
the name of the primary (largest) letter or charac- 
ter on it. This is the P key, then. Press it. 


Two things have happened: the word PRINT has 
appeared at the bottom of the screen, and the 
cursor —which has moved to the right of PRINT 
—has changed from [fg to J. 


Eg means keyword. Whenever the J is on the 
screen, pressing a key will always cause the 
“keyword” above the key to appear on the screen. 


The cursor will also always change to [. This is 
because each keyword is a command to the com- 
puter, and needs to be followed by some informa- 
tion (or “‘data’’) to apply that command to. 
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The & Cursor. . .the Main Characters on 
the Keys 
One of the keys you will need most is the DELETE 


CJ ' | key, just above the P. Let’s erase PRINT. Press the 
We DELETE key. 
ci PEEK 


PUT. 

LJ 

CK Ur Now what? Not only is PRINT still on the screen, 
so is 0. 


Here's why: when the [J cursor is on the screen, 
the T/S 1500 will print the large white letter, 
number or other item on the key. 


PRINT off 


A clue: the word DELETE is in black on the key. 
Look at the SHIFT key (in the lower left corner of 
the keyboard). The word SHIFT is in black, too. 


The Shift Key. . .Characters in Black on 
the Keys 

Try pressing SHIFT and (while holding it down) 
pressing the 0 key. 


Press SHIFT while you 
press DELETE 


Do it again. 


PRINT 


14 J, DELETE, SHIFT 
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SHIFT, DELETE, £J, [J 


DELETE — SHIFT 0— Erases the Character 
or Keyword to the Left of the Cursor. 

Now, try typing in and then deleting things — 
letters, numbers, keywords—one at a time. Try 
typing in a few things and then deleting them all. 
Remember: 


If the [jis on the screen, you'll get the keyword 
above the key. 


If the jis on the screen, you'll get the primary 
character (the large white one) on the key. This is 
usually a Pjetter or numeral. 


If you press any key while holding SHIFT, you'll 
get the character on the key in black. 


Does this happen with the [J cursor on the screen 
or only with the fj? Try it and see. 


What happens if you press a key with no keyword 
over it, when [fg is showing— like a number? Or 
the key marked ENTER? 


Whatever you have on the line at the bottom of 
the screen, you can always get back to the begin- 
ning by pressing DELETE (SHIFT @) as many 
times as you need to. 


As a last resort, you can also unplug the computer 
and then plug it back in.. .it always starts “from 
scratch’’ when it’s first plugged in. (Caution: this 
is a last resort because you will lose any informa- 
tion in the computer when you unplug it—don’t 
do this if you want to keep anything you've previ- 
ously typed in.) 


Now, you know how to get 


1. Keywords above the keys (), 
2. Letters in white on the keys (§§), 
3. Symbols in black on the keys (SHIFT). 
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The [&] Cursor. . . Inverse Video and 
Graphic Symbols 

On some keys, there's a ‘graphic symbol’’ —look 
at the R key, for instance. 


Lt 
DIM (Se 5 
[.2.] a C23] Ca)|C) I How do we get that? 
ARCTAN 


With yet one more cursor, that’s how. Press 
SHIFT 9 (‘'GRAPHICS”’). 


The [J cursor says you are in graphics mode. 
Now press the R key. 


Press SHIFT while you 


press 9 
Hmmm... . still not the symbol, but something 
else interesting. It is the inverse of the main 
character. Try it with some other keys. 
So how do we get Mil and the other graphic sym- 
bols? Try holding SHIFT while pressing the key. 


~ < Okay, SHIFT while in graphics mode gives you 
a Cee at the symbol. Try a few more. 
ster 


[. at | What about keys that don’t have a graphic 
ARCSIN symbol on them? What do you get with SHIFT 
core va Falll: while the [¥ cursor is showing? Try some. 


LN EXP 


SHIFT while in Graphics 
gives you symbol 


16 Ej, GRAPHICS, SHIFT 
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TAB 


i DELETE, FUNCTION, ff] 


You can turn off the [qj mode by pressing SHIFT 9 
again. Press it a few times— it turns the [J cursor 
on and off. (You will also find that pressing the 
ENTER key will ‘‘turn off’ the [jj cursor. But don’t 
use this method; it’s a bad habit that will cause 
trouble later.) 


Okay, by now we have a long line of graphic 


symbols and inverse characters. Let’s get rid of 
them with DELETE. 


The Hi Cursor. . . Keywords Under the 
Keys 
How do we get the words under the keys? 


Many of those are mathematical functions, so we 
use the ‘‘function mode.” 


Look at the ENTER key. 


Try holding down SHIFT and pressing ENTER. 
What happens to the cursor? 


It changes to 


Now press the P key. 


You should see TAB. 


is just like [fj (except that you choose when 

to use the J cursor), but produces the words under 
the keys. The [J changes to [J after you press a 
key and obtain a function keyword. (If you just press 
ENTER, it changes back to ff or [, whichever 
one it came from. Again, don’t get in the habit of 
using ENTER to ‘‘turn off’ the [jj mode.) 
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TAB SIN 


PRINT ABCDEFGGIJKLMY 


Change it back to [jj (SHIFT ENTER). Press 
another key —try QO. 


Just for fun, try entering a few more, then 
DELETE them all and get back to a single Fj 
cursor on the screen. 


The Syntax Error Marker 

If, at any time during this chapter —or any other 
time, for that matter — you see what looks like an 
Ei cursor, it means you have tried to enter into 
the computer an instruction that it cannot handle. 


The is not a cursor at all, but the syntax error 
marker. Syntax has to do with the structure of a 
language — the way words can be assembled into 
sentences —and BASIC is a language with very 
strict syntax rules. The T/S 1500 knows what it 
can do, and will sometimes say, ‘I can’t do that’’ 
with an j marker. 


For the purposes of this chapter, don’t worry if the 
Ei appears; we'll be explaining it later. For now, 
just dispose of the offending line with DELETE. 


The Cursor Arrows 
There are a few more keys you'll find very helpful. 
Try typing in a line like this: 


PRINT ABCDEFGGIJKLM 
(Yes, put in a second G instead of H. We need a 
mistake to correct.) 


In order to correct the second G, we could DELETE 
our way back to that spot, erase the G, and then 
retype the letters, starting with a correct H. 


Instead of deleting and then retyping all the 
letters, try SHIFT 5, the left-pointing arrow. 
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The cursor moves over, in among the letters, 
without deleting any. 


PRINT ABCDEFGGIJKL[EM 


Press it a few more times, until the cursor is just 
to the right of the second G. Remember, DELETE 
eliminates the character to the left of the cursor. 


Now press SHIFT @ (DELETE). 


PRINT ABCDEFGG§IUKLM 


And type in the correct letter, H. 


PRINT ABCDEFGHPIJKLM 


You can move the cursor through a line to the 
right with the right arrow, SHIFT 8, as you might 
expect. Try moving the cursor back and forth. 


Try moving it up and down with SHIFT 6 and 
SHIFT 7. Nothing happens, because there is only 
one line to work with. We'll use the up and down 
arrows in a later chapter. 


Our tour of the keyboard is now complete. To get 
ready for the next chapter, take a look at the key- 
words LOAD and SAVE. We'll use them next. 


In the meantime, feel free to exercise the keyboard 
some more. 
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the Keyboard 


Summary 

1. Ej cursor: the keyword above the key. 

2. cursor: the main symbol in white on a key, 
usually a letter or number. 

3. SHIFTed key: the black symbol on the key. 

4. Bicursor: the function under the key. Cursor 
obtained by SHIFT ENTER. 

5. [@cursor: inverse of main character on a key. 
Cursor turned on/off by SHIFT 9. 

6. SHIFTed key in [J mode: the graphic symbol 
on the key. If no graphic symbol, the inverse 
of the black symbol. 

7. DELETE (SHIFT 0): erase one entry at a time 
to the left. 

8. Asample key for reference: 


Eicursorisinverse ... 
SHIFT, with 
SHIFT, with Hor 


cursor 


a 
2 
id 
n 
° 
R 
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i Using Ready-To-Run 3 
§ Programs 


Chapter Preview How to use prerecorded 
programs on cassette 
tape, and store your own 
programs with LOAD 
and SAVE. We look at 
RUN and REM. 


As of now, there are many programs available for 
the Timex Sinclair 1500 computer, programs which 
are fun and programs which are useful. Timex has 
a large library of them, and many other sources 
are also producing T/S 1500 programs. It is cer- 
tain that there will be many more in the weeks 
and months to come. You will find that programs 
written for the Sinclair ZX81, the predecessor of 
the T/S 1500, will run on your computer, and of 
course programs for the Timnex Sinclair 1000 will 
as well. 


Sometimes you will need to load a program into 
the computer from a tape. When you are done and 
turn off the computer, it will disappear from the 
T/S 1900's internal memory but, of course, you will 
still have it on tape to load and use again. This is 
how you will usually use games, for example. 
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Ed 


Load 


Sometimes you will type in a program from a book 
in order to use it, and then will want to save it onto 
a tape cassette. Then, the next time you want to 
use it, you won't have to type it in, but simply load 
it from the cassette. 


And sometimes there will be programs you will 
load from a tape, add data to, and then save the 
program with the data on another part of the tape, 
separate from the original program. 


Let’s look at how each of these is done. 


Loading a Program From Tape 
Important: Before using a tape recorder with 
your computer, please read the separate sheet 
titled ‘Timex Sinclair 1500 Compatible Cassette 
Recorders’’ — This sheet contains the latest 
recorder recommendations. 


Every program should have a name, and any 
cassette that has more than one program on it 
should provide you with an index listing the 
names of all the programs on the tape. 


With all the components of your system con- 
nected and turned on, as discussed in Chapter 1, 
make sure that your tape is rewound to the begin- 
ning, and that the [ cursor is on your TV screen. 


Connect the EAR socket on the computer to 

the earphone or headphones socket on the tape 
recorder. Turn the volume control on the tape re- 
corder to about three-quarters of the maximum 
volume; if it has tone controls, adjust them so the 
treble is high and bass is low. 


Then press 


LOAD 


LOAD 


Programs 


LOAD "f§ 


SHIFT, LOAD, ENTER 
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which is what you get when you press the J key 
while the [J cursor is showing (remember, when- 
ever the [fg cursor is on the screen, pressing any 
key will give you the keyword command above 
that key). 


You'll notice that the cursor has changed to fj. 
This means that the computer now will give you 
the main symbol on any key you press, or —if 
you hold the shift key down while you press 
another key—the shifted symbol, which is in 
black (the same color as SHIFT) on the key. 


You will want to instruct the computer to load 
the program you want to use, so you must put 
the name in quotes. Suppose you want to run 
a program for a game called STAR ZAP. 


Hold down the SHIFT key and press the P key, 
and you'll get quotation marks. 


Then, without SHIFT, type in the name of the 
program, making sure you have it exactly right 
including spaces. Then type SHIFT P again for 
quotation marks. Your screen will look like this: 


Now press the PLAY key on your cassette 
recorder, and then press 


ENTER 


on the computer keyboard. (LOAD is a command 
that tells the computer what you want it to do, 
“STAR ZAP’ tells it what to do it with, and ENTER 
is the signal that the instructions are finished, and 
the T/S 1500 should start the job.) 
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Searching 


nnn 


Loading 


0/0 
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The TV screen will show you a pattern of thin ee 


lines on the white screen, during the time the com- 
puter is searching for the program on the tape. 


When the program has been found and is being 
loaded into the computer's memory, the screen 

pattern will change to heavier black lines alter- 

nating with white. 


When the computer has finished loading the 
program, one of two things will happen: 


1. Some commercial programs will begin running 
automatically, usually with a “‘title screen”’.or 
instructions to the user. (You should stop the 
tape immediately at this point so as to be in 
the proper position to load the next program 
if you wish.) 


OR 


2. The screen will be blank, except for a 0/0 in 
the lower left hand corner. The 0/0 is a report 
code and means that the computer has suc- 
cessfully loaded the program (more about report 
codes later). Again, stop the tape immediately. 
To execute the program, then, you press 


RUN (the R key) 

and 

ENTER 

to start the program. 


If you are using a cassette with more than one 
program on it, and wish to load a program that is 
not the first one, you will see the patterns of thin 
(searching) and thick (loading) lines more than 
once. Each program that goes by will cause a 
‘Joading’’ pattern on the screen, even though the 
computer is not loading it—the T/S 1500 will only 
start actually loading when it comes to the pro- 
gram you have named. 


Occasionally a program will fail to load properly, 
and you'll have to investigate the reason and/or 


Ui 
UI 
7 
¥ 
Ui 
i 


UW 


0/0, LOAD, RUN tf 
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Programs 


try again. You'll know a LOAD has misfired if 


1. The [fj cursor comes back on the screen. 

2. The ‘‘searching’’ pattern comes back on the 
screen after the ‘‘loading’’ pattern (if you are 
certain that loading pattern was for the pro- 
gram you wish to load). 


If the [J is on the screen, you don't have to do 
anything except rewind the tape in order to try 
again. 

If the searching and loading patterns are still 
going on the screen, you need to press the BREAK 
key to stop the process. Then you'll be ready to 
check into the problem. 


The most likely problem is that the volume level 
is too high or too low. It needs to be (a) loud eneugh 
for the computer to pick up the program, (b) not so 
loud that the program is distorted (this is actually 
fairly rare), and (c) quiet enough for the silent part 
to be recognized as silent by the computer. 


A way to determine the optimum volume setting 
for your particular recorder is to load a short (2K) 
program at various volume settings, noting the 
lowest and highest settings that produce accept- 
able loadings, then set your recorder volume in 
the center of that range. If no volume setting can 
be found that proves successful, you may have 
other problems. 


Some tape recorders can form a feedback loop 
with the T/S 1500. For this reason, we recom- 
mend connecting only one lead at a time; if you've 
recorded something with both EAR and MIC con- 
nections made, you may not be able to load it. 


Some tape recorders can record a 60 cycle AC 
hum. This can be avoided by operating them on 
batteries. 


Some tape recorders— especially old, worn 
ones — are intrinsically noisy, produce a lot of 
extraneous noise on their tapes. You may have 
to invest in another recorder. 
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You may have to wiggle the plug in the earphone 
socket; on some recorders contact is lost if the 
plug is pushed in too far. If you pull it out just a 
bit, you may feel it settling into a more secure 
position. 


It is possible that you have a tape that was 
recorded (SAVEd) on another recorder, and the 
recording heads on that machine are out of align- 
ment. This is likely if the program can be loaded 
from that recorder, but not from yours. If you have 
trouble with a lot of tapes, including commercial 
ones, your recorder’s heads may need adjusting. It 
is even possible that both recorders are slightly out 
of adjustment — not enough to keep them from 
saving and loading their own or commercial tapes, 
but enough that they cannot use each other's tapes. 


It is possible to load a program without using its 
name. If you type 


LOAD **" 


LoAD ""f (that is, press the J key and then SHIFT P twice; 
do not put a space between the two quote marks), 
then start your recorder and press ENTER, the 
T/S 1500 will load the first program it comes to. 
This is useful if you have only one program on a 
tape, if you know you want the first one, or if you 
know you want the next one but have forgotten 
its name. 


Typing in a Printed Program and Saving 
it on Tape 

Many shorter programs are available in books 
and magazines. You can use them by simply typing 
them in. Type them exactly as they appear in the 
publication, making sure your spellings are correct, 
and all punctuation and spaces as well. 


You can check yout listing by comparing what 
you have on the screen with the printed version. 
See Chapter 2 for how to easily make corrections. 


a i 
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[| RUN, ENTER, BREAK, REM 


Beware — it is possible for the original listing in the 
book or magazine to have errors! You may type it 
correctly and still have trouble. 


Note: It is a good idea to put the name of a 
program into the listing of that program, so you 
can doublecheck that you have the right one. The 
easiest way is to add a REM line at the beginning. 
You'll notice that nearly all programs are numbered 
in multiples of 10, so if a program doesn't already 
have a line giving its name in the listing, you can 
just type 


5 REM PROGRAM: STAR ZAP 


using a line number lower than the lowest in the 
listing (the computer will then automatically put 
it at the beginning) and, of course, the actual 
name of your program. 


When you've finished typing the program in, you 
execute it by pressing 


RUN and ENTER 


as above. When you've finished using it — either 
you reach the end, or you interrupt the program 
by pressing the key marked BREAK — you can 
get the listing back on the screen by pressing 


ENTER 


again. Then, after verifying (by using it) that the 
program works and that you've typed it in correctly, 
you can save it for future use on tape. (You don’t 
have to try it out first, of course, but then you might 
be going to the trouble of saving a program that 
won't run.) 


Saving a Program on Tape 

As we said earlier, every program should have a 
name. The T/S 1500, in fact, won't save a program 
on tape without a name. You can make up a name 
for a program you invent, use the name of a pro- 
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gram you have typed in as above, or even change 
that name to something you like better. Whatever: 
you call the program when you save it will be the 
name you have to ask for to load it later. 


Connect the MIC socket of the computer to the 
microphone socket of the recorder. Position the 
tape in a part that is blank, or a part that you are 
prepared to overwrite. Enter the following: 


SAVE "STAR zap" SAVE "STAR ZAP"’ 


using the keyword SAVE over the S key. 
Start the tape recorder, on RECORD, then press 
ENTER 


Watch the TV screen. You'll see a pattern of 
black and white lines — different from either the 
“searching” or ‘‘loading’’ patterns — and eventu- 
ally the screen will show 0/0, which in this case 
means ‘‘the SAVE is complete.” 


As acheck on whether the recorder has received 
the program correctly, you can listen to it over the 
Saving speaker. Rewind the tape to where you started 
and play it back. You should hear, in order: 


1. Asoft, humming buzz. This is the signal 
before you pressed ENTER. 

2. Five seconds of silence. 

3. Avery harsh, high-pitched buzz, which is 
the program itself. This will go on longer for 
a longer program. 

4. The soft, humming buzz again. 


Note: A technique that may make it easier to 
find programs you record is to speak the name 
of the program onto the tape through the micro- 
phone before connecting the computer to the 
recorder. Then you can search for the sound of 
your announcement to find the program. 


You can check on your success at saving a program 
by following the LOAD instructions above. 
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LOAD "CALCULATOR" 


SAVE "FINANCES" 


fil ENTER, SAVE, LOAD, RUN 


Saving Programs with 

Your Own Data Entered 

Some programs are meant for you to enter your 
own data into—saving lists, figures, etc. These 
are easily used by following the same procedures 
we've just discussed. 


1. LOAD the program as we've described. 
2. RUN the program, entering your own data as 
it is called for. 


3. SAVE the program with the data in it, usinga 
new name to distinguish it from the original 
program. If, for example, you load a program 
called ‘Calculator’ and then fill in your per- 
sonal financial records, you may want to 
save the filled-in version under the name 
“Finances.”’ 


As you can see, there are many ways to use your 
Timex Sinclair 1500 without learning computer 
programming. But if you'd like to look into it, try 
the next chapters. 


Summary 

1. Many programs are available for use with the 
Timex Sinclair 1500 computer, and you don't 
have to know how to program to use them. 

2. The LOAD command followed by the name of 
a program in quotes causes the computer to 
load that program you play into it from a tape 
cassette. 

3. LOAD followed by two quotation marks with 
nothing between them causes the T/S 1500 to 
load the next program on the cassette tape. 
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4. The SAVE command followed by the name of 
a program in quotes tells the computer to send 
that program to a cassette recorder running in 
recording mode, saving the program on the tape. 

5. You must have a name for the program when 
using SAVE, but you can make up any name 
you like, and change the names of alternative 
versions of the same program (like a program 
into which you put information that is updated 
periodically). 
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'| What To Do 


Chapter Preview PRINT and ENTER help 
you start giving orders 
to the T/S 1500. Learn 
how to put words and 
numbers on the screen. 
We look at the quotation 
marks, ‘‘strings,"’ and 
how to use functions 
like SOR. 


We saw, in Chapter Two, how the keyboard works. 
In Chapter Three, we talked about loading and 
saving programs on tape. Starting with Chapter 
Five, we'll be learning how to write our own 
programs. 


This chapter is a bridge between what has gone 
before and what comes after, if you want to go on 
into programming. 


It is also a repetition of some of what is in Chapter 
Two, to increase your skill on the keyboard— even 
if you don’t want to become a programmer. 


As we have said, the computer is a very versatile 
machine. It can do many things, as long as it is 
told what to do. But it has to be told in words it 
can understand, and in small steps it can 
execute. 


The Timex Sinclair 1500 is built to understand 
orders given to it in BASIC (which stands for 
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‘Beginner's All-Purpose Symbolic Instruction eat 
Code’’). Invented at Dartmouth College, BASIC LI 
looks more like English than other languages and 
is very easy to use. 


The keywords above the keys, which are commands |_| 
to the computer, are in English. They are also in 

BASIC, which means each word always means 
exactly the same thing. g 


For example, the keyword we will probably use 
the most is PRINT. In English, this can mean 


1. Make letters on paper with a writing instru- a 
ment held in your hand, 

2. Transfer letters from a printing press to paper, 
or 


3. Publish. LI 
There are probably several other meanings you . 
could think of, slightly different from these. 
In BASIC, PRINT means only one thing: LU 
1. Print on the screen whatever follows the word 

PRINT. 
Let’s have some more practice at giving the e 
computer commands and see how it performs. 


Start by setting up the computer so that the 
screen looks like this. | 


Now we'll have the computer figure out the sum 
of 2 and 2, and show the result on the screen. 


First, type PRINT. Press the P key, and the word a 
PRINT appears. Remember, although you can 

spell out the word PR,I,N,T, you give the T/S 

1500 its orders using the keywords above the 


keys. These appear if you press a key while the L 
PRINT E@ cursor is on the screen. 

In case you haven't noticed, we are indicating 

keywords in this manual by printing them in LI 

BOLD FACE TYPE. 


Besides the word PRINT appearing on the screen, 
you see that the cursor has changed to fj. — 
PRINT |] 
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PRINT 28 


PRINT 2+ 


PRINT 2+2[ 


S 


PRINT 


SHIFT, ENTER, PRINT 


Next, type 2. The 2 appears on the screen, and 
the [¥§ moves to the right. Notice, by the way, that 
there is a space between the PRINT and the 2 on 
the screen. Timex Sinclair BASIC keywords come 
with their own spaces, and you don’t have to put 
them in (it won't do any harm if you do put in 
extra ones). : 


Third, type a plus symbol (+). Remember how 
we obtained symbols that are in black on the 
keys— using SHIFT. Hold down SHIFT and press 
the fj Key. 


Next, type another 2. The screen will look like this: 


Finally, press ENTER. Whenever you are finished 
with a line or a command, and want the computer 
to do something, you signal this by pressing 
ENTER. 


The computer will compute and display the 
answer. Of course, you don’t need a computer 

to figure that one out, but you can use it for more 
difficult math (see Chapter 10). 


| Let's try something else. The 0/0 report code is 


“hiding” a fj cursor —if you press a key while a 
report code is on the screen, you'll get a keyword 
just as if a [J was showing. So press P again, and 
get PRINT. 
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PRINT " 


PRINT "2+2"[ 


It’s okay that the answer to the previous calcula- 
tion is still on the screen. 


Now, using SHIFT, get quotation marks by press- 
ing P again. 

And press 2. And + (using SHIFT again). And 
another 2. 


Finally, close the quotation (SHIFT P). The screen 
should look like this: 


Now press ENTER. 


Aha. Let us examine why the difference. The first 
time, when we typed 


PRINT 2+ 2 


we were telling the computer to evaluate a math- 
ematical expression and print the answer. 


The second time, when we typed 
PRINT "2+ 2” 


we were telling the computer, ‘‘Don’t do any cal- 
culation, just print whatever is in quotes.” 


Try this (remember that, inside the quotes, you 
will have to put in spaces where you want them, 
using the SPACE key in the lower right corner of 
the keyboard). 


PRINT “ANYTHING THAT APPEARS IN QUOTES 
NO MATTER HOW LONG IT IS” 


Don’t forget to press ENTER when you are done. 


Here's some computer jargon for you: anything 
we put in quotes is called a string. This sounds 
odd at first, but it essentially means that the entire 
“string” of characters within the quotes is treated 
by the computer as a single item. 

PRINT 
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PRINT §++2Qq 


PRINT ++[ll2 


PRINT +f¥+2 


PRINT [+2 


SHIFT, DELETE, FJ 


What To Do If You Make a Mistake 

If you make a mistake, you can erase it with the 
DELETE key (SHIFT 0). Pressing DELETE erases 
the character just to the left of the cursor. 


And, you can move the cursor to where you want 
to make a deletion by using the left and right arrow 
keys (SHIFT 5 and SHIFT 8). 


For instance, type 
PRINT + +2 


and press ENTER. 
The screen will look like this: 


Remember that the J is the syntax error marker. 
It means that the T/S 1500 cannot execute that 
command (you can't add 2 to +). Of course, we 
meant PRINT 2 + 2, so let’s make the correction, 
the way we did in Chapter Two. 


First, we need to move the [J cursor to the scene 
of the crime. Press the left arrow (SHIFT 5, holding 
down the SHIFT key while pressing the 5 key). 
The cursor moves one place to the left. 


Press the left arrow again, which puts the cursor 
in the proper position. 


Now press DELETE (SHIFT 0) and we have this 
on the screen. 
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PRINT 2[§+2 


PRINT SQR 2[f 
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We can then put in the correct character. Type 2. 


Now, we can press ENTER. We don't need to 
move the ff cursor back to the end of the line: 
it doesn’t matter where it is, as long as the rest 
of the line is correct. The cursor is just a place 
marker, for your eyes only. 


Time to practice: 


Try typing in PRINT ‘“‘ and then any sentence you 
like. Don’t forget to close the quotes at the end. 


Practice moving the cursor backwards and 
forwards through the line with the left and right 
arrow keys. 


Make any corrections you like, before pressing 
ENTER. Besides correcting errors you may notice, 
try adding new words by moving the cursor to the 
spot where you want to insert them and then 
typing the words. 


Practice making up a line of graphics, by pressing 
PRINT “ and then getting into graphics mode with 
SHIFT 9. Remember, you have to use SHIFT 9 
(GRAPHICS) again to get out of the graphics 
mode in order to close your quotes and ENTER 
the line. 


In case you are mathematically inclined, here’s 

a quick early hint on the use of functions. Press 
PRINT, then enter the function mode by pressing 
SHIFT ENTER. With the [§J cursor on the screen, 
press the H key, giving you SOR (for square root). 
Then press 2 and ENTER. 


The computer evaluates the mathematical expres- 
sion and prints the square root of 2— 1.4142136 — 
on the screen. 


SHIFT, ENTER, SOR, PRINT 
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PRINT, ENTER 


We won't spend much time on the other functions 
in this manual, except to mention them in Chapter 
10 and list them in Appendix A. If you are a math- 
ematician and recognize the abbreviations under 
the keys, fine. If not, don’t worry about them. 


Summary 

1. PRINT (keyword command located above the 
P key) tells the computer to print something 
on the screen. 

2. Ifa number follows PRINT, the number will 
be printed on the screen; if a mathematical 
expression (like 2 + 2) follows PRINT, the 
expression will be evaluated and printed 
(for example, 4). 

3. Anything in quotation marks after PRINT will 
be printed on the screen exactly as it appears. 
The matenal in quotes is called a string because 
it is a string of characters. 

4. When you press ENTER, you signal the com- 
puter that you are finished writing your com- 
mand and would like it carried out. 

5. Report Codes are printed by the computer in 
the lower left hand corner of the screen when 
it stops executing its instructions. The codes 
tell you whether it has successfully carried out 
your orders or whether it has encountered a 
problem. 
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HELLO JACK 
HELLO JACK 
HELLO JACK 


Chapter Preview How to start with NEW, 
repeat with GOTO, stop 
with BREAK, and con- 
tinue with CONT. 


We are now ready to write our first computer 
program. 


In the last chapter, we were operating in what is 
called the immediate mode, which means that the 
computer executed each command immediately. 


When we write programs, we give a number of 
commands and the computer executes them, in 
order, when we tell it to. Until we tell it to execute 
—and afterwards, for that matter—the T/S 1500 
remembers all the commands. 


Although we will start small, there are programs 
of many thousands of lines, which direct computers 
to carry out lengthy and complicated procedures. 
The power of computing is in the ability of the 
machine to receive, store and carry out many 
different complex programs. 
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PRINT "HELLO, JACK" 


HELLO, JACK 


10 PRINT "HELLO, JACK" 


Let’s get started. If you are just plugging in the 
computer to start this chapter, you should have 
the [fg cursor in the corner of the screen. If you 
are continuing from the last chapter, press NEW 
(the A key, while the [fj cursor or a report code 

is showing). This clears both the screen and the 
computer's memory, so it is ready to start a NEW 
program. (Don't forget to press ENTER.) 


Type in 


PRINT ‘HELLO, JACK” 


and press ENTER. Just as in the last chapter, the 
computer executes the command immediately. 
(By the way, you can use your own name instead 
of Jack if you prefer.) 


Now type in 
10 PRINT ‘‘HELLO, JACK” 


Notice that the [fg cursor doesn’t change as you 
type the 1, and then the 0. This is why there are 
no keywords over the number keys: so you can put 
in program line numbers. It changes to f¥ after 
the keyword PRINT. 


If you-are a typist, by the way, be careful to use 
the numeral 1 and not the lower case L for a 1. 
For one thing, the computer doesn’t.have lower 
case letters. And for another, each character, like 
each keyword, can only mean one thing to the T/S 
1500. 
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Be careful also to use the numeral 0 (zero) and 
not the letter O. We will show zeros with the 

slash mark through them to distinguish them 
from letter O’s (this is common in computing). 


Now press ENTER. Notice that the entire pro- 
gram line has appeared at the top of the screen... 
instead of just the words HELLO, JACK. 


You will also notice a symbol between the 10 and 
the PRINT. This is the program cursor. It is placed at 
the line most recently entered into the program 
(and we'll use it for something later). 


1ORPRINT "HELLO, JACK" 


The only difference between the first line we typed’ 


and the second was the line number. When we 
put a number in front of a command, it becomes 
a program line and is not immediately executed. 


The cursor is ready again at the bottom of the 


screen. Type this: 


20 GOTO 10 ENTER 


2@ GOTO 16 Note that GOTO is a keyword (over the G key) 


and should not be spelled out (in fact, it appeared 


as soon as you pressed the G). Notice, also, that . 
the program cursor now shows at Line 20. 


10 PRINT "HELLO, JACK" Now you have a complete, if brief, program. The 
command in line 20 simply tells the computer to 
go back to line 10 and start over. Can you guess 
what will happen when you execute the program? 


20RcoTo 10 


simply press 
RUN 


ENTER 


Let's try it and see. To execute a program, you 


(the keyword over R), and 
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HELLO, 


D/10 


How about that? That’s a lot of stuff on the screen 
for such a short program. As we said, the computer 
is not very smart. But it is fast, accurate, and tire- 

less doing repetitions. 


One of the most powerful commands in BASIC is 
the GOTO, which is often used to direct the com- 
puter to go back to an earlier program line and 
repeat a process over and over again. 


You'll notice the report code 5/10 at the bottom 

of the screen. That means it stopped because the 
screen was full (5—see the Report Codes at the 
back of the book), and the last line it executed 
was number 10. 


You can clear the screen and allow the program 
to go on by pressing CONT (for CONTinue), the 
keyword over the C key, and ENTER. 


Here’s something else. While the computer is run- 
ning HELLO, JACKs down the side of the screen, 
press the BREAK key (which doubles as the 
SPACE key when a program is not running) and 
notice that the list stops wherever it was when 
you pressed BREAK. 


The report code for BREAK is D and any program 
line number may appear after the slash. 


The computer checks at the end of every program 
line to see if anyone has pressed BREAK; if so, it 
stops the program. (You can also use BREAK to 
stop a runaway program—like an “‘endless 
loop,”’ about which we'll say more later—or a 
misfired LOAD from a tape cassette. If BREAK 
doesn't work, you may have to resort to pulling 
the plug which, of course, means you lose any 
information in the computer.) 


You can restart the program after BREAK, also by 
pressing CONT and ENTER. CONTinue lets you 
continue when the screen is full, when you inter- 
rupt the program with BREAK or STOP, or when 
the program itself interrupts with the STOP com- 
mand. (STOP is used rather than BREAK within 
CONT, BREAK, SPACE, STOP 


Chapter 5: Writing a Program 


SRL Se a a a 
a program, or when the program is waiting for 
input—yes, we'll be talking about STOP later, 
too—and BREAK is used while a program is in 

full gallop.) 


fF cae aie. eee Okay. After you've had your fill of fooling around 
20—c0T0 10 ‘ with BREAK and CONT, let the program stop with 
a full screen, and press ENTER again. 


Your program is back on the screen again. You 
can RUN it again (go ahead, press RUN and 
ENTER). 


You can also leave it in the memory and go on to 
something else. It will stay there until you erase it 
or unplug the machine. 


But there is one caution. Let's look into it. Get the 
program listing back on the screen, by pressing 
ENTER when it stops. 


Now, type in 


10 PRINT ‘GOODBYE, JACK” 


\®@ PRINT "GOODBYE, JACK" 


and press ENTER. 


MOBPRINT "GOODBYE, JACK" 


2@ GOTO 10 The new line 10 replaces the old line 10 in the 
program. (And the program cursor shows that 
Line 10 was the last one you entered, even 
though it is not the last one in numerical order in 
the listing on the screen.) 


There can only be one line 10 and any time you 
enter a new one, you lose the old one. This means 
that, if you leave a program in the T/S 1500 
(instead of restarting with NEW), you run the risk 
of having the new program erase the old one. Or, 
worse, of having some lines from the old program 
interwoven with lines from the new one. 


RUN, NEW 43 
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SBREM PROGRAM: GOODBYE 
10 PRINT "GOODBYE, JACK" 
20 GOTO 1 


GOODBYE, JACK 
GOODBYE, JACK 
GOODBYE, JACK 
GOODBYE, JACK 
GOODBYE, JACK 
GOODBYE, JACK 
GOODBYE, JACK 
GOODBYE, JACK 
GOODBYE, JACK 


5/18 


5 REM PROGRAM: GOODBYE 
'10 PRINT "GOODBYE, JACK" 
15BPRINT “SEE YOU LATER" 
26 GOTO 10 


SEE YOU LATER 
GOODBYE, JACK 
SEE YOU LATER 
GOODBYE, JACK 
SEE YOU LATER 
GOODBYE, JACK 
SEE YOU LATER 
GOODBYE, JACK 
SEE YOU LATER 


5110 


Try this: 
5 REM PROGRAM: GOODBYE 


and press ENTER 


Program line 5 has been inserted into the program 
where it belongs in numerical order. This is why 
we usually number the lines in multiples of 10: 

it gives us room to insert new lines if we find we 
need them. 


Now press RUN and ENTER. 


The program line (5) beginning with the key- 
word REM doesn’t ‘‘do’’ anything in the program. 
Any line beginning with REM— for REMark or 
REMinder— appears in the listing to help the user 
understand the program — but is disregarded by 
the computer when running the program. 


As another example, try typing 
16 PRINT ‘‘SEE YOU LATER’”’ 


and ENTER 


and RUN the program. Then press ENTER again 
to show the listing. Can you see why the program 
does what it does? 


Now you might want to try to write a few simple 
programs of your own, using lines of strings to print 
or of mathematical calculations. Or even mixing 
the two (remember, the computer will do exactly 
what you tell it to do, even if the result doesn’t 
make any sense). 
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NEW, RUN, GOTO, CONT, BREAK 


Summary 


NEW erases everything that might have been 
typed into the computer, to make room for a 
new program. 


. When you put line numbers in front of com- 


mands, they become program statements 

and are not executed immediately. Instead, 
they are carried out in numerical order in 
response to the RUN command. 

GOTO is a very powerful BASIC command. It 
directs the computer to a line in the program 
other than the next one in numerical order, 
and allows the computer to repeat sequences 
of program lines over and over. 

BREAK stops a program while it is executing. 
CONTinue restarts a program that has stopped 
for certain reasons, most often because BREAK 
has been pressed or the screen is full. 
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"5 REM PROGRAM: GOODBYE 


20 GOTO 10 


10 PRINT "GOODBYE, JACK" 
1SPRINT "SEE YOU LATER" 


Arranging Outputon 6 
the Screen 


Chapter Preview This chapter shows you 


how to use EDIT, AT, 
TAB, commas and semi- 
colons to move things 
around. We use the up - 
and down arrows. 


You can do wonders with punctuation marks ina 
T/S 1500 BASIC program. For instance, let’s start 
with the program we finished the last chapter with: 


5 REM PROGRAM: GOODBYE 
10 PRINT ‘‘GOODBYE, JACK"”’ 
15 PRINT ‘SEE YOU LATER" 
20 GOTO 10 


The Program Cursor 

and the EDIT Command 

We'll add some punctuation. If you retyped that 
program for this lesson, you'll see the program 
cursor, which looks like this—§—at line 20, 
which was the last line you typed in. Press the 

up arrow (SHIFT 7) and it will move to line number 
15. Press the up arrow again and the cursor moves 
to line 10. 
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(If you are starting this chapter right after finish- 
ing the last one, the program cursor is at line 15. 
Press the up arrow just once to move it to line 10.) 


Then press EDIT (SHIFT 1) and line 10 will appear 
in the workspace at the bottom of the screen. 


10M PRINT "GOODBYE, JACK" 


The Comma 

Now move the cursor to the end of the line by 
repeatedly pressing the right arrow (SHIFT 8). 
Then type in a comma (SHIFT PERIOD), and 
ENTER. 


10 PRINT "GOODBYE, JACK", 


The program doesn't look much different. But 
5S REM PROGRAM: GOODBYE ‘ 
1OMPRINT "GOODBYE, JACK’, press RUN and ENTER. 


a3 een ag YOU LATER" 
The T/S 1500 screen is 32 characters wide (they 
are numbered 0-31 instead of 1-32, by the way), 
and the comma moves the print position to the 
beginning of the next half screen. 


SEE YOU LATER 


What happens if you add a comma to the end 
See you LATER of line 15 in the same way? Does it change the 


See you LATER output (what appears on the screen)? Why or 
why not? 


No punctuation at the’end of a PRINT statement 
moves the print position to the beginning of the 
next line. 


SEE YOU LATER 


A comma at the end of the print statement 
moves the print position to either column #16 
(the right half of the screen) or position #0 (the 
beginning of the next line), whichever is next. 
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5S REM PROGRAM: GOODBYE 
1OBPRINT "GOODBYE, JACK "; 
15 PRINT "SEE YOU LATER" 
20 GOTO 10 


GOODBYE, JACKSEE 
5/15 


10 PRINT "GOODBYE, JACK"; 


@ PRINT "GOODBYE, JACK ff"; 


EDIT, DELETE, @; > , > 


Reminder: what's the difference between the 
comma inside the quotes and the comma outside? 


The Semicolon 

Using the same technique as before (arrows, 
cursors, EDIT key) and the DELETE key, replace 
the comma at the end of line 10 with a semicolon. 


Move the program cursor to line 10 with the up 
and/or down arrows (SHIFT 6, SHIFT 7). 


Bring the line down into the work area with 
EDIT (SHIFT 1). 


Move the cursor to the end of the line with the 
right arrow (SHIFT 8). 


Erase the comma with DELETE (SHIFT 0). 
Add a semicolon (SHIFT X). 

Press ENTER. Now RUN the program. 
Hmm. What have we here? 


A semicolon moves the print position one space 
from where the previous statement ends. 


We have to figure out a way to leave a space 
between the two phrases. 


The way you do it is to add a space inside the 
quotation marks. Same way as before: 


Press ENTER to get the program listing. 
Move the program cursor to line 10. 
Press EDIT to bring it down. 


Move the cursor with the right arrow to a position 
just before the quotation marks. 


Type a SPACE. It is inserted at the point of the 
cursor. If you want to get fancy, back up the 
cursor (with the left arrow) to before the space 
and also add a comma. 
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5 REM PROGRAM: GOODBYE 


7 JACK "; 


20 GOTO 10 


, JACK 
, JACK 
1 JACK 
2 JACK 
, JACK 
1 JACK 
, JACK 

JACK 
1 JACK 
, JACK 


, JACK 


Press ENTER. 


Press RUN and ENTER. 


Note: if, for any reason, you want to separate 
two numbers, you have to add spaces in quotes, 
which means you have to add the quotes, too. 


PRINT 1234 prints 1234 
PRINT 12 34 prints 1234 
PRINT 12; "34 prints 12 34 


Don't forget the semicolons. . . 


What would happen if you put a comma at the 
end of line 15? What about a semicolon? 


There are other ways to position printing on the 
screen. Let’s try them. 


TAB and AT 
First, let’s clear the computer by pressing NEW 
and ENTER. 


Then, type in this program: 


5 REM PROGRAM: CHAPSIX 
10 PRINT TAB 10; ‘‘CHAPTER SIX” 
20 PRINT AT 5,3; ‘PUNCTUATION 
AND THE SCREEN" 
30 PRINT 
40 PRINT 
50 PRINT 
60 PRINT 
70 PRINT TAB 5; “INFORMATION” 
80 GOTO 70 
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SNAPTEG ETL Press RUN and ENTER. Nice page, eh? 


PUNCTUATION AND THE SCREEN 


What does the report code 5/70 mean? 
rareanay 

INFORMATION Hint: Check the Report Code appendix. 
INFORMATION 
INFORMATION 
INFORMATION 
INFORMATION 


oe uacaine navitd Let's examine the program, line by line. Press 
28 PRINT ATS Se"BUNCTURTION ENTER to get it back on the screen. 
EEN 


Line 5 is just our standard REM statement, 

PogPethr {AS cS STNFORMATI ONY containing the name of the program (the same 
name we use to LOAD or SAVE it). This is not 

required, but is probably a good habit to get into. 


Line 10 prints beginning at column 10 across 

the screen—just like the TAB key of a typewriter, 

except that you specify the column number in the 
program line. Remember to obtain TAB as a func- 
tion (under the P key), using SHIFT ENTER to get 

into function mode, rather than spelling it out. 


Notice the semicolon after TAB 10. TAB 10 puts 
the ‘‘print position’’ at the 10th column, but a 
comma would move it to column 16 and defeat 
the purpose of the TAB statement. And no punc- 
tuation at all would result in a syntax error marker. 


Is PRINT, “JOE” (with the comma) the same as 
PRINT TAB 16; ‘““JOE''? 


Line 20 prints AT a location defined by the two 
numbers—the first is the line number, the second 
is the column number (five lines down, three col- 
ummns across). AT is also a function keyword, under 
the C key. Notice, again, the semicolon. 


Lines 30-60 each print a blank line, effectively 
moving the print position down by four lines, 
before line 70. 


Line 70 prints, on the next line and at the specified 
TAB location, its information. 


Line 80 causes line 70 to repeat until the screen 
is full. 
[| NEW, REM, SHIFT ENTER 51 
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Could you change line 70 to read 


[as 


PRINT AT 10,5; “INFORMATION” 


CHAPTER SIX Try it and RUN the program. pe 
eh al one Hint: You'll have to use BREAK to stop the | | 
program. 


Does it make any difference if you add a comma 
at the end of line 70? Why or why not? 


How about if you add a line 75 that reads like the 
AA Ped ee mere ty original line 70, and change the GOTO in line 80, 


2@ PRINT AT 5,3; "*PUNCTUATION A 


ag ye gemeen reas 


18054 Mego! | | 70 PRINT AT 10,5; “INFORMATION” 
75 PRINT TAB 5; “INFORMATION” 
80 GOTO 75 


CHAPTER Six Then RUN and ENTER. 


PUNCTUATION AND THE SCREEN 


INFORMATION 


What happens if you press CONT and ENTER? 


— a i 


The Quote Image 

You may be wondering, if quotation marks tell 
the computer where to start and stop a string, 
how can you print quotation marks themselves 


= 


| fOBPRINT TAB 5;""" INFORMATION" on the screen? || 
80 GOTO 70 
: The double set of quotes on the O key is called 
the quote image, and serves that function. as 
PRINT, AT, BREAK 1] 
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CHAPTER SIX 
PUNCTUATION AND THE SCREEN 


"INFORMATION" 
"INFORMATION" 
"INFORMATION" 
"INFORMATION" 
"INFORMATION" 
"INFORMATION" 
"INFORMATION" 
"INFORMATION" 
5/70 


1OBPRINT TAB SsMJACK"ZAT 5,10; 
JACK", ,,,TAB S3"JACK" 


SHIFT P, SHIFT Q, TAB, AT 


Let's eliminate line 75 by typing 75 ENTER, 
change line 80 back to 


80 GOTO 70 


(Just type in the new line 80 and it replaces the 
old one), and then change line 790 to look like this 


70 PRINT TAB 5; ' “INFORMATION” "' "” 


(after TAB 5; you type SHIFT P and then SHIFT O 
and, after typing INFORMATION, type SHIFT O 
and then SHIFT P) you will get a curious look- 
ing arrangement in your program listing but the 
right kind of quotation marks when the program 
prints it. 


Remember, keep the quote image (SHIFT QO) 
inside the real quotation marks (SHIFT P). 


Here’s something else you may want to try. In 
some forms of BASIC, you can have more than one 
command on a program line, but not in T/S 1500 
BASIC. However, you can have multiple PRINT 
statements on one line. 


First, we need to remove the CHAPSIX program 
from the computer. Type NEW and ENTER (This is 
the last time we'll remind you to do this. . .). 


Then type in the following one-line program— 
very carefully! 


10 PRINT TAB 5; "'JACK"’; AT 5,10; ‘“‘JACK’’,,,, TAB 
5; “JACK” 


RUN the program. 


It will print the screen shown at the left. TAB 5 
prints in the first line at column 5, AT 5,10 prints 
at line 5, column 10, the four commas then move 
the print position to line 5, column 16, then line 6, 
column @, then line 6, column 16, then line 7, col- 
umn @, and then the TAB 5 moves it to column 5, 
still on line 7. 
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54 PRINT TAB, PRINT AT 
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the Screen 


Try a few arrangements yourself. 


Summary 

1. After a PRINT command with no punctuation 
following, the print position for the next print 
command moves to the beginning of the next 
line on the screen. 


PRINT “JACK” 


2. Acomma after a print command moves the 
print position to the middle of the screen, or 
to the beginning of the next line, depending 
on whether the end of the item that has just 
been printed is in the left- or right-hand half 
of the screen. You can use more than one 
comma to move the print position as far as ql 
you like by half-lines. , 


PRINT ‘‘JACK"’,,, 


3. The semicolon moves the print position just 
one character space to the nght. 


PRINT ‘JACK’; 


4. TABsets the print position at the column called 
for by the number following TAB. Remember, 
column 0 is really the first column, column 9 
is really the tenth, and so on. 


PRINT TAB 10; “JACK” 


5. AT sets the print position according to two num- 
bers as co-ordinates, separated by a comma: 
the first is the line number (counting down from 
the top of the screen) and the second is the 
column number (counting across from the 
left edge) 


PRINT AT 5,15; ““JACK’’ 
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the Screen 


AT, TAB 


6. TAB and AT move the print position; before 
printing what is on their program line: the 
comma and semicolon move the print position 
after, in preparation for the next line, so you 
could have both: 


PRINT AT 5,15; “JACK”’,, 


7. The quote image (SHIFT OQ) is used to print 
quotation marks on the screen. 
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i) Space with Variables 


0/40 


SHIFT, LET 


Chapter Preview You learn to use the LET 
command to name num- 
bers, words or sentences. 
We clear the screen with 
CLS and the memory 
with CLEAR, and intro- 
duce ‘‘variables."’ 


10 LET A = 5328 

20 LET A$ = "FRED" 
30 PRINT A 

40 PRINT A$ 


Type in the above program. Remember the SHIFT 
key for $, =, and’. Then press RUN and ENTER. 
Can you see what has happened? Press ENTER 
again, and your program listing will be back on 
the screen. 


Lines 10 and 30 have the same effect as if you had 
typed PRINT 5328. The letter A, when preceded 
by LET and followed by = , becomes a variable. 
In the program above, of course, it takes more 
time and more memory space in the computer to 
do it this way. But if you had a program where the 
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10 LET A=5328 

20 LET A$S="FRED" 
30_PRINT A 
4ORPRINT AS 


number was printed several times, using the var- 
iable A instead of the entire number 5328 each 
time would be quicker, and would save precious 
memory space in the computer. 


In some programs, as we will see later, the num- 
ber that A stands for changes during the program; 
that’s why A is called a variable. 


The program statement 
10 LET A = 5328 


is called an assignment statement because it 
assigns a value (5328) to a variable. The letter A 
is called a variable name. A variable name does 
not have to be a single letter. It can be any length 
and contain letters or numbers but the first char- 
acter must be a letter. The statement could be 
written 


10 LET NUMBER = 5328 
10 LET THIS NUMBER = 5328 
10 LET A5328 = 5328 


and so forth. 


Lines 20 and 40 do the same thing as lines 10 and 
30, except that A$ is a string variable. (A$ is pro- 
nounced ‘‘A string” rather than ‘‘A dollar sign.”’) 


Strings can be any length — whatever is between 
quotation marks—but the name of a string variable 
must be one letter followed by $. You could write 


25 LET A$ = “HELLO” 


25 LET A$ = ‘WAY DOWN UPON THE SWANNEE 
RIVER” 
25 LET B§$ = “5328” 


Now we have the program on the screen. Press 
the V key, which in keyword mode will give you 
CLS, and press ENTER. 


— ee 


LET, CLS | 
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CLS stands for CLEAR SCREEN. The program is 
gone. But if you press ENTER again, it comes back. 
Tt was taken off the screen, but it stayed in memory. 
Now press the A key, for NEW, and ENTER. Then 
press ENTER again. The program, this time, is 
gone. NEW erases everything in the computer 
and on the screen, and readies the T/S 1500 for a 
NEW program. 

Let’s go back to the immediate mode and try 
something else. Type 


LET A=5 ENTER 


then press ENTER again. No PISgTER, Nothing in 
the computer? Try 


PRINTA ENTER 


Well, what do you know? The computer saves 
variables! Now this can get cluttered after a while, 
so there is a command to clear variables out of the 
memory. Press 


CLEAR ENTER 
then 
PRINTA ENTER 


As the table of report codes at the back of the book 
tells us, 2/0 means we have an undefined variable. 
That’s because we took the variable A and its 
assigned value out of the memory with CLEAR. 


Let’s try something else. Type this program 


10_PRINT AS 
[| 20BcoTo 10 
10 PRINT A$ 


20 GOTO 10 


remembering, of course, to type ENTER at the 
end of each line. 


[| NEW, CLEAR, GOTO 59 


Chapter 7: Saving Time and 
Space with Variables 


LET AS="TIMEX SINCLAIR 1500" 


=X SINCLAIR 1500 


SINCLAIR 1500 
SINCLAIR 1500 
SINCLAIR 1500 


X SINCLAIR 1500 


SINCLAIR 1500 


‘TIMEX SINCLAIR 1500 
5/16 
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From now on, we're not going to talk about ENTER! 
But you must remember to press ENTER after every 
command or program line. 


Can you guess what will happen when we RUN 
this program? Try it. 


(Did you remember ENTER?). 


A 2/10 report code this time— because we didn't 
define the variable A$. Press ENTER to bring back 
the program. Now type, without a line number, 


LET A$ = ‘TIMEX SINCLAIR 1500” 


(or any other words if you prefer). Press ENTER 
again to get the program back on the screen and 
notice that the assignment statement isn’t in it 
(because we didn't give it a number). 


Now type 
GOTO 10 


GOTO 10 started the program running, and it 
used the variable that was stored in the computer's 
memory. Why did we use GOTO 10 instead of RUN? 
Try to execute the program using RUN. 


When you use RUN to execute a program, in 
effect you are saying CLEAR the variables and 
then GOTO line 1, the beginning of the program. 
This is so that leftover variables do not gum up the 
program. But if you want to use previously entered 
variables, just start a program with GOTO. 


Enter a new string value for A$, using the LET 
statement. Run the program again, using GOTO. 
Then press CLEAR. Get the program back again 
with ENTER. Run it with GOTO again. 


CLEAR eliminates variables, but leaves the 
program in the T/S 1500. 


RUN, GOTO, CLEAR 
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3. String variable names are a single letter and $. 
. String variables can be any length, enclosed 


ONaOD 


o 


LET assigns values to variables. 


. Numeric variable names begin with a letter 


and can be any length. 


by quotes. 


. CLS clears the screen. 


CLEAR erases variables from the memory. 


RUN starts a program after clearing variables. 
. GOTO starts a program (at any line number 


you choose) without clearing the variables. 


. NEW clears everything from the computer. 


LET, CLS, CLEAR, RUN, GOTO, NEW 
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Chapter Preview Repetitious work is easy 
with FOR, TO, NEXT, 
and STEP. We also use 
LIST to print the pro- 
gram on the screen. 


THIS LooPiG HAS 
GoT To STOP... NOW 
Til Just 19 Let y=... 
Z << i 

] 10 FORI=1TO 10 
20 PRINT ‘‘NUMBER"’, I 


30 NEXT I 


Type this program into your Timex Sinclair 1500. 
In line 10, do not spell out TO, but use SHIFT 4. 
RUN the program. 


We said earlier that GOTO was a very powerful 
BASIC statement. We used it to make a program 
repeat, by telling the computer to GOTO an earlier 
line number and execute the same operations 


10 FOR I=1 TO 10 again. 
20 PRINT "NUMBER",I ; ; 
3ORNEXT I The process of repeating the same operations a 


number of times is called looping, and the part of 
the program that repeats is called a Joop. When 


RUN, GOTO, TO, FOR 63 


Chapter 8: Programs That /| 
Repeat: Looping 


SSeS RRO ES eG eh SDN ES ee RU ae ene avast ran 
we simply use GOTO, we have no control over how 
many times the program repeats; in fact, it does not 
stop (until the screen fills, or we press BREAK). 


NUMBER 


NUMBER 
NUMBER 
NUMBER 
NUMBER 
NUMBER 
NUMBER 
NUMBER 
NUMBER 
NUMBER 


This is called an endless loop, and is not too useful. 


POONOU RUN 


The FOR/NEXT Loop 

We need loops that are under our control. In 
Sinclair BASIC, the best way to do this is with 
what is called a FOR/NEXT Joop. The program 
above shows the form of such a loop: 


Line 10 contains the keywords FOR and TO, a num- 
‘ber indicating how many repetitions are desired, 
and a counter or control variable. A control variable 
in a FOR/NEXT loop must be one single letter. Com- 
puter jocks usually use I, but any letter will do. 


Line 20 contains the action that is to be repeated L 
within the loop. There can be many lines of activity ~ 
here, not just one. 


Line 30 is necessary to close the loop. It tells 
the computer where to stop and go back to the 
FOR line. 


Try this: get the program back on the screen with 
38 PRINT "NUMBER", I ENTER, then add 
25RJPRINT ——$——— 
30 NEXT I 


25 PRINT “ aS 
Se eee 


Between the quotes is the graphic symbol on the 
7 key. Remember how to get it? 


After you’ve pressed SHIFT P for the “’, press 
SHIFT 9 to enter the graphics mode, with the 
cursor on the screen. Then press SHIFT 7 (7 with- 
Terre out SHIFT is just inverse 7) 32 times, because the 


NUMBER 4 . 2 
NUMBER 3 screen is 32 characters wide. 


NUMBER $. 
Ti at aa Then press SHIFT 9 to exit the graphics mode and, 


eet _i___- | with the [J cursor showing, close the quotes with 
etc... SHIFT P. (Then ENTER all that.) RUN the program 
and you'll see a dandy bunch of underlining. 


64 FOR, TO, NEXT 
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NUMBER 4 
NUMBER 3 
NUMBER 5 
NUMBER 7 
NUMBER 9 


6/30 


ENTER, LIST, STEP 


Incidentally, another way to determine if you've 
got your full 32 characters —a full line on the 
screen — between the quotes is to see that the 
close quote is one space past the open quote (but 
on the next line). Put another way, see that the 
material between the quotes would meet if it 
were on the same line. 


The LIST Command 

Bring back the program with ENTER. You see 
the program cursor on line 25 — the last line you 
entered. We want to EDIT line 10. But instead of 
using the cursor arrows, let's look at another 
technique. Type 


LIST 10 


In most BASICs, pressing ENTER does not bring 
back a program listing as it does on the T/S 1500. 
The command LIST is required, and you can add 
a line number for where to begin the listing. When 
you do that on the Timex computer, you get the 
program cursor at the first line on the screen. (This 
is much more useful when you want to edit line 
number 90 in a program that goes to line 220 than 
itis for our example. . .) 


Adding STEP to the FOR/NEXT Loop 
Nevertheless, we have the program cursor where 
we want it. Press EDIT and bring line 10 down, 
then use the right cursor arrow (SHIFT 8) to move 
to the end of the line and add STEP 2— using 
SHIFT E, not spelling out STEP): 


10 FORI=1 TO 10 STEP 2 


Enter the line back into the program, then RUN. 


STEP does just what you’d expect: it “counts by’”’ 
the number following the command STEP. How 
would you get the program to count 2, 4, 6, 8, 10 
rather than 1, 3, 5, 7, 9? Try it. 
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You can ‘‘count down” with STEP, too. Try 
changing line 10 to read 


10 FORI= 10 TO1STEP -2 


Will the computer count down by ones if you say 


10 FORI=10 TO 1 


or do you have to add STEP - 1? Try it and see. 


Nested Loops 

Can you have a loop inside a loop? Certainly. Many 
times, you'll want to repeat actions which contain 
other actions which you also want repeated. You 
can do this more or less indefinitely, as long as 
the loops are properly nested. Try this: 


10 FORI=1TO5 
20FORJ=1TO5 

30 PRINT 1;°:"";J;"°"; 
40 NEXT J 

50 PRINT 

60 NEXT | 


Be careful with line 30: get it just right, and put 
a space between the second pair of quotes. And 
notice we had to pick a second letter, besides I, 
to count for the second loop. 


RUN the program. 


Effectively, the rows are created by the ‘‘I-loop” 
and the columns by the ‘‘J-loop.’’ (The PRINT in 
line 50 serves to move the print position to the 
Lloop J-loops beginning of the next row to start a new I loop.) 
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The loops are correctly nested, because the entire 
J-loop is contained within the I-loop. You will have 
a problem if the loops overlap. Sometimes you'll 
get error messages, sometimes you'll just get 
incomprehensible results. Try exchanging lines 
40 and 60, so the program looks like this: 


10 FORI=1TO5 
20 FOR J=1TO5 


40 NEXT I 
50 PRINT 
60 NEXT J 


RUN it and try to figure out what you have! 


One other problem you must be careful of when 
using FOR/NEXT loops: you can’t ‘‘jump’’ into the 
middle of a loop from the outside by using a GOTO. 
When it hits the NEXT command without having 
passed a FOR, the trouble will start. 


1 FOR/NEXT loops, using the keywords FOR, 
TO and NEXT, and a control variable, give you 
controlled repetitions. 

2. Control variables are named by any single 
letter. 

3. STEP is used in a FOR/NEXT loop to count 
by anything other than ones, and by negative 
numbers. 

4. Multiple loops must be nested, not overlapped. 

5. LIST brings a program listing to the screen; with 
a line number after LIST, it starts the listing at 
that number and places the program cursor at 
that line. 
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INPUT, IF, THEN 


Chapter Preview IF and THEN are used, 
with the mathematical 
relations =, <,>,<=, 
> =,and <>, tomake 
decisions. We also use 
INPUT to give informa- 
tion to the T/S 1500. 


We've considered three of the four reasons that the 
computer is such a powerful and valuable tool: 


1. It works fast. 

2. It can remember a lot of information, includ- 
ing its own instructions (programs). 

3. Itcan repeat operations over and over, tirelessly 
(looping). 

Now let us look into the fourth: 

4. The computer can make decisions. 


A program can contain a number of instructions, 
some of which are carried out by the computer in 
some cases, and others which are carried out in 
other cases. Such a program is said to branch, or 
to be a branching program. The command that 
makes all this possible is IF. 
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1@ PRINT "NUMBER", "LARGEST SO 
FAR" 


20 INPUT A 
30 LET LARGEST=A 
4@ PRINT A,LARGEST 
50 INPUT A 
60 IF LARGEST<A THEN LET LARGE 


ST=A 
7eBcoto 40 
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10 PRINT “NUMBER”, ‘‘LARGEST SO FAR" 
20 INPUT A 

30 LET LARGEST =A 

40 PRINT A,LARGEST 

50 INPUT A 

60 IF LARGEST< A THEN LET LARGEST =A 
70 GOTO 40 


Type in the program above but before you RUN 
it, let’s talk about it—line by line—to review 
some earlier points and raise some new ones. 
THEN, incidentally, is SHIFT 3, not spelled out. 


Line 10 is a simple print statement; the 

comma between the two strings means they will 
be printed at positions @ and 16 on the screen— 
the left edge and the middle. 


Line 20 is an INPUT statement. It asks for some 
information from the user, and assigns the input to 
a variable named A. When you RUN the pro- 
gram, the {J cursor at the bottom of the screen 
signals you that the T/S 1500 is waiting for your 
input. More about INPUT in a moment. 


Line 30 sets a variable, LARGEST (notice that the 
variable name LARGEST helps you remember 
what it is) equal to the variable A. 


Line 40 prints those two variables, directly 
under the labels printed in line 10 (notice the 
comma again). 


Line 50 asks you to input another number and 
assigns it to A. This replaces the previous value 
for A. 


Line 60 is the decision statement. IF the number 
that is called LARGEST is LESS THAN (< ) the 
new value for A, the program sets it to be equal 
toA...the latest input is the ‘‘largest so far.’’ If 
LARGEST is already larger than A (or equal to 
it), itis left alone. 


Line 70 creates a loop by going back to line 40. 
Then only the portion of the program between 
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INPUT, BREAK, STOP 


lines 40 and 70 is repeated, as often as you 
care to keep entering new numbers. 


Okay, now RUN the program and enter some 
numbers to see how it works. 


The STOP Statement 

Because there is an endless loop in the program, 
it won't stop by itself. (This is a less serious prob- 
lem in a program that pauses to wait for input 
than it would be in a program that could keep 
running.) To terminate the program, when the 
cursor is on the screen waiting for input, type 
STOP (SHIFT A).instead of inputting a number. 


Then you can recall the listing with ENTER, or 
restart the program with RUN. 


As we will see in a moment, we can also tell a 
program when to STOP itself by putting that 
command in a program line. 


It is also possible to interrupt this program 

by pressing the BREAK key, but you have to be 
fast—this only works when the program is not 
waiting for input. Try it: you have to press BREAK 
when the [J cursor is not on the screen. 


The INPUT Statement 

The command INPUT, followed by a variable 
name, stops the program until you enter a value 
for that variable. The [J cursor appears at the 
bottom of the screen; that is your clue that the 
computer is waiting for input. 


It is usually preferable to insert a PRINT state- 
ment just before an INPUT statement, describing 
the information the program needs. For example, 
we might add to our program 

15 PRINT ‘‘ENTER A NUMBER” 


and 


45 PRINT “ENTER A NUMBER” 
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NUMBER 
ENTER A NUMBER 


5 
ENTER A NUMBER 


LARGEST SO FAR 
5 
21 
ENTER A NUMBER 
60 


6e 


60 
ENTER A NUMBER 
40 


ENTER A NUMBER 


Try it and see what happens. That’s a little clut- 
tered. We could erase the prompt with CLS each 
time, so that you would notice it when it came 
back—but then we'd erase our column of num- 
bers and our heading! 


Here’s a fancy way to add a prompt. Eliminate 
the new lines 15 and 45, if you added them above. 
Remember, you delete a line by replacing it with a 
blank line with the same number, so you'd type 
15 ENTER and 45 ENTER. 


Then try adding a few lines so the program looks 
like this (remember, in lines 15, 40 and 45, AT is 
the function under the C key and is not spelled out): 


10 PRINT '‘NUMBER” “LARGEST SO FAR” 
15 PRINT AT 20,1;‘"ENTER A NUMBER"’ 

20 INPUT A 

25 PRINT AT 20,1;" 

30 LET LARGEST = A 

35 LET X =3 

40 PRINT AT X,0; A, LARGEST 

45 PRINT AT 20,1;‘'ENTER A NUMBER’”’ 

50 INPUT A 

60 IF LARGEST< A THEN LET LARGEST = A 
65 LET X=X+1 

70 GOTO 40 


Lines 15 and 45 PRINT the prompt AT line 20, 
on the bottom of the screen (and starting at col- 
umn position 1), while lines 25 and 55 effectively 
erase the prompt by ‘‘printing’’ a string of blank 
spaces instead. 


Line 40 has to be changed to specify the loca- 
tion of the printing of the next pair of numbers 
because the PRINT AT command in lines 15 and 
45 moves the print position to line 20. If we did 
not change line 40, the next pair of numbers 
would be printed on line 21. 


LET, PRINT AT 
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ENTER A NUMBER 


LARGEST SO FAR 


ENTER A NUMBER 
J 


We use the variable X for the line in that PRINT 
AT statement in line 40. Line 35 defines X and 
prints the first pair of numbers on line 3, then 
line 65 increases X so that each repetition of 
the loop prints the numbers on the next line. 


Incidentally, doesn't line 65 look odd? What 
kind of math is X = X + 1? Well, of course it isn’t 
math at all, but another assignment statement. 
It means ‘‘let X equal the previous value of X, 
plus one.”’ 


This means you have another way of writing a 
loop. It is a little clumsier than a FOR/NEXT loop, 
so we seldom use it. The one advantage it has is 
that you could use a more descriptive variable 
name in place of X—you might say 


35 LET LINE = 3 
65 LET LINE = LINE +1 


where, you will remember, variable names 
that count for a FOR/NEXT loop must be only a 
single letter. 


Try erasing line 65 and see what happens. It is 
because X is not increased, and returns to line 3 
each time we repeat the loop. 


Can you print your prompts in lines 15 and 46 in 
inverse letters? 


The IF Statement 

The IF statement checks to see whether a par- 
ticular condition is true; if it is, the rest of the 
statement on that line is executed. If it is not, the 
rest of the line is ignored and the program moves 
to the next line. 


Often the form of the statement is like 


40 IF A=5 THEN GOTO 100 


[1] IF, THEN GOTO, LET, FOR/NEXT 
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LET I=1 

PRINT 1*100 

LET I=I+1 

IF I=6 THEN STOP 
GOTO 20 


10 FOR I=1 TO 5 
20 PRINT I*100 
3@ NEXT I 


meaning that if a variable called A is equal to 5, 
the program goes to line 100 and starts running 
at that line. If A is not equal to 5, the next line 
executed would be the one after 40 (probably 
50, right?). 


In T/S 1500 BASIC, by the way, we must include 
the THEN in line 40 (some BASICs let you omit 
it). Among the things THEN does is to return the 
Eg cursor to the screen so you can use a keyword 
like GOTO; otherwise you wouldn't be able to 
give the computer any commands to execute 
IFA=65. 


Sometimes—as in the example at the beginning 
of the chapter—we have to INPUT the value on 
which the decision is made. More often, the value 
results from some calculations within the pro- 
gram. We can even use IF to terminate a loop: 


10 LETI=1 

20 PRINT I*100 

30 LETI=1I+1 

40 IF 1=6 THEN STOP 
50 GOTO 20 


How would you write that program using a 
FOR/NEXT loop? 


10 FORI=1TO5 
20 PRINT I*100 
30 NEXT I 


The IF statement compares values using these 
mathematical symbols: 


= is equal to SHIFT L 
<_ isless than SHIFT N 
> is greater than SHIFT M 
<= is less than or equal to SHIFT R 
>= is greater than or equal to SHIFT Y 
<> is not equal to SHIFT T 


STOP, =,<,.>,< =,> =,<> 
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Do not assemble a ‘‘less than or equal to’’ sign by 
typing SHIFT N and SHIFT L. You must use 
SHIFT R for the combination. The same goes for 
>=and<>. 


Comparing Strings 

You can also use the symbols to compare strings. 
Usually you will do this with = or <> toseeifan 
input matches a previously-chosen word. Type in 
this program, in which Fred wants you to try to 
guess his name. 


10 INPUT A$ 

Jo Iueur as, 20 IF A$ = ''FRED" THEN GOTO 40 
; 30 GOTO 10 

40 PRINT A$ 


RUN the program. Notice the [¥ cursor at the 
bottom of the screen is in quotes, prompting you 
to enter a string. 


FRED Make a few wrong guesses, then input the right 
answer. 


Now try this: add a new line 
0/40 5 LET B$ = ‘‘FRED" 


and change line 20 to read 


5 LET BS="FRED" 
3 1 aseeas THEN GOTO 40 20 IF A$< = B$ THEN GOTO 40 
cOPRINT AS 


You can use the cursor arrows, EDIT and DELETE, 
to substitute or you can just type a new line in. 
You are replacing ‘‘FRED” with B$, and the = 
sign with < = (SHIFT R, not SHIFT N and SHIFT L). 


Then guess these names, JIM, HARRY, JOE, and 
AL. What happened? 


The mathematical symbols operate on a string 
by comparing the first letter of the string. If the 
first letter of A$ comes earlier in the alphabet 
than the first letter of B$, then A$ is said to be 
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less than B$. If the first letters of two strings are 
the same, then the second letters are compared, 
and so on. So, with strings: earlier in the alphabet 
is less than, later in the alphabet is greater than. 


In fact, what the computer actually does is 
compare the code numbers of any characters in 
the T/S 1500's character set. If you refer to the 
Appendix titled THE CHARACTER SET, you'll 
find that A> 9. The alphabet follows the numer- 
als in the character set, so any letter is greater 
than any numeral. 

Test this with Fred's program. Type in a number— 
say, 25—in answer to the input request. 

How would you add prompts to Fred's program— 
like ‘‘Guess my name”’ and ‘‘Wrong. Guess again’’? 


Hint: you can also change line 40 to read 
40 PRINT ‘RIGHT. MY NAMEIS._ "';A$ 


but only if you have the = sign in line 20, not the 
< =. Notice the space just before the close 
quote. 


AND, OR, NOT 

We call = <,>,< =,> = and<> relations. We 
can combine them by using the logical relations 
AND, OR and NOT. 

IF A=BANDC=D THEN GOTO 100 


means that if both pairs of variables are equal, 
the program goes to line 100. 


IF A< BOR C> D THEN GOTO 100 


sends the program to line 100 if either A< B or 
C> Dis true. 


IF NOT A=B THEN GOTO 100 


AND, OR, NOT 
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WRONG. MY NAME IS NOT HARRY 


THAT IS RIGHT, 


MY NAME IS FRED. 


IF, THEN GOTO, PRINT 


is the same as 
IF A< > B THEN GOTO 100 


In Sinclair BASIC, unlike some other ‘‘dialects,’’ 
you must include both THEN and GOTO in lines 
like the above, to enable the unique keyword 
system to operate. 


But in addition, using both makes the program 
clearer and easier to understand. 


Let’s add a few lines to the name-guessing 
program: 


10 PRINT ‘GUESS MY NAMB” 
20 LET I1=0 
30 INPUT A$ 
40 IF A$ = FRED” THEN GOTO 110 
50 LETI=I+1 
60 IF A$< > ‘FRED’ AND 1=3 THEN GOTO 90 
70 PRINT ‘‘WRONG. MY NAMEIS NOT “;A$ 
80 GOTO 30 
90 PRINT ‘‘SORRY, YOU LOSE.” 
100 GOTO 120 
110 PRINT ‘‘THAT IS RIGHT,” 
120 PRINT ‘MY NAMEIS FRED." 


RUN the program and try a few guesses. The 
combination of relations in line 60 stops the 
game if you've had three guesses. Trace the logic in 
the program and figure out how and why it 
moves from one line to another. 


Try to tidy up the screen a bit by adding 
15 PRINT 
and 


75 PRINT 
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1@ PRINT "GUESS MY NAME” 
20 LET I=@ 

30 INPUT AS 

40 IF AS="FRED" THEN GOTO 116 
5S@ LET I=1+1 

60 IF AS<>"FRED" AND I=3 THEN 


PRINT "WRONG. MY NAME IS NO 
T SAS 


8@ GOTO 30 

90 PRINT “SORRY, YOU LOSE." 
10@ GOTO 12: 

11@ PRINT “THAT IS RIGHT," 
120 PRINT "MY NAME IS FRED." 
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Now we have a confession to make. Did you 
discover, when you analyzed the program, that 
line 60 doesn't need both relations? 


Since line 40 transfers the program to line 110 if 
A$=‘FRED" then, logically, A$ must be not 
equal to ‘FRED’ if we have reached line 60. So 
line 60 really only needs to say 


60 IF 1=3 THEN GOTO 90 


Try it and prove it to yourself. The lesson in this is 
to always plan a program carefully in advance 
and work out the logic of it so that you do things 
in the most direct way. The search for the sim- 
plest solution to a programming problem is what 
makes programming fun! 


Summary 


1. INPUT causes a program to stop and wait 
for a number or a string to be entered. An 
cursor at the bottom of the screen signals that 
the computer is waiting for a number, and 
“By means a string is expected. 

2. Itisa good idea, even with the cursor serving as 
a ‘prompt’ for INPUT, to PRINT a line ex- 
plaining the information the program wants; the 
PRINT statement should be in the program 
line just before the INPUT statement. 

3. STOP (SHIFT A) can be input in response to 
the [J cursor prompt, and stops the program. 

4. IF/THEN evaluates a condition; if the condi- 
tion is true, the program does what is called 
for after THEN (usually GOTO another loca- 
tion in the program); if not, the next line in the 
program is executed. 


INPUT, STOP, IF, THEN, GOTO 
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5. IF evaluates mathematical values using the 
relations 
= equal to 
< less than 
> greater than 
= less than or equal to 
= greater than or equal to 
<> not equal to 
6. More than one mathematical relation can be 
combined, using 
AND (both are true) 
OR (either is true) 
NOT (a relation is not true) 
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Chapter Preview You can add, subtract, 
multiply, divide and use 
built-in functions like 
RND and INT. 


PRINT 2345678 
If you have used a calculator, you are used to 
typing in something like this 


2+2= 


and getting the answer. Try this on your T/S 1500. 
Nothing happens. Press ENTER. A syntax error 
marker appears. 


This doesn't look promising. Press SHIFT 0 
(DELETE) until you get rid of it all. 


You can use your computer as a calculator, but 
you have to ask the right questions. Try this: 


PRINT 2+ 2 
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Okay, that’s more like it. You can use any math- 
ematical operation in the same way. The signs are 


+ SHIFTK addition 

— SHIFTJ subtraction 

»  SHIFTB multiplication 

/ SHIFT V_ division 

** SHIFTH raising to a power 


The addition and subtraction signs are the ones 
you are used to. Division uses a sign you have 
probably seen, because the computer does not 
have the + sign in its character set. And an as- 
terisk is used to stand for multiplication because 
the X is being used as a letter. 


Raising a number to a power is a special case. 
The T/S 1500 cannot insert or understand super- 

’ scripts, which is what we call our usual notation, 
so we use the ** symbol. (Other computers and 
BASICs use other symbols.) 


32. = 3squared = OF*2 
33 = 3cubed = 78" 83 
34 = 3tothe fourth power = 3**4 
310 = 3tothe tenth = 3**10 


All of these mathematical operations can take 
place in programs, of course. 


Priorities and Parentheses 

If you have a program line containing a number 
of mathematical operations, the Timex Sinclair 
1500 will perform them in this order: 


First, it will work out any powers, starting with 
the left end of the line and working to the right. 


Second, it will do all multiplication and division, 
again working from left to right. 


Finally, it will do all addition and subtraction, 
once again from left to right. 


These are called the priorities, and are part of 
the way the computer is designed. Just as the 
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character set includes more than just the letters 
of the alphabet, in fact, the priority rankings go 
well beyond the basic mathematical operations— 
a complete table can be found in Appendix A. 


You may want to have operations performed in 
an order different from the computer’s way, and 
you can arrange this by using parentheses: any- 
thing in parentheses is done first (left to right) 
and the result is treated as a single number. 


For example 
PRINT 3*44+3=15 


because 3*4 = 12 (multiplication first) and then 
124+3=15. But 


PRINT 3+«(4+ 3) =21 


because 4 + 3 = 7 (parentheses first) and then 
3*7 = 21. 


You can go further, putting parentheses inside 
parentheses (correctly nested, just like loops): 
the innermost parentheses will be done first, 
and then the computer will work its way out 
from there. 


Scientific Notation 

Sometimes, when a number is going to be more 
than 14 spaces long, the T/S 1500 will print it in 
scientific notation instead. This is a number with 
one digit to the left of a decimal point, some digits 
to the right of it, and then an E (for exponent), a 
+ (or sometimes a minus) and a number which 
multiplies the rest of the expression by powers 
of 10. 


For example, 
2.34E + 14 


is 2.34 times 10 to the 14th power. 
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Try typing in any number more than 14 digits 
long (after a PRINT statement), like 


PRINT 2345678923456789 


and see what happens. 


You can also use scientific notation in entering 
numbers, and the computer will convert the num- 
ber to an ordinary expression—until it gets to 
be more than 14 digits long, and then it will go 
into scientific notation itself. Try 


PRINT 2.34E0 
PRINT 2.34E1 
PRINT 2.34E2 


and so on. At what point does the computer 
start returning scientific notation? 


The T/S 1500, with PRINT, also has a habit of 
displaying only eight significant digits. Type 


PRINT 123456789 


and see what the computer displays. 

Have no fear—the T/S 1500 is holding the 
accurate number even though it rounds off and 
shows only the eight significant digits. Try 
PRINT 123456782 

to check the rounding-off process, then 


PRINT 123456782 + 4 


to see that it’s all there (if it weren't it would 
round down again). 


Rounding Errors 
All computers have a problem with rounding 
errors—answers which are sometimes slightly 
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incorrect due to the ‘‘rounding off’’ process. This 
is inherent in the binary-to-decimal conversion 
operation. Most large computers have editing 
routines to correct for this built into their math 
handling procedures, but small personal com- 
puters lack such a feature. 


If you were to write 


100 LET A = 300.3 — 236.11 - 55 
110 PRINT A 


you would get an answer from the computer of 
9.1899999, when the correct answer is 9.19. 
You can correct for this by adding 


105 LET B = INT(A+100 + .5) 
and then changing line 110 to read 
110 PRINT B 


Functions 

Many mathematical functions are built into 
Sinclair BASIC. To take the square root of 9, for 
example, you would type 


PRINT SOR 9 


using the function SOR under the H key. Remem- 
ber, you get a function with the [§J cursor, which 
you obtain by pressing SHIFT ENTER. 


We will not spend any more time on functions at 
this time; you'll find them all defined in Appendix 
A. As we said back in Chapter Four, mathema- 
ticians probably know them anyway and the 
rest of us probably don't need them. . . 
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The Random Number Generator 

There is one function we want to discuss a bit 
further, because it is very useful in programming 
educational exercises and games. That is the 
random number generator. 


The function RND, located under the T key, gives 
you a number between @ and 1. Try a few of them: 


PRINT RND 


Now, this may not seem terribly useful, but you 
can massage it a bit to make it give you whole 
numbers in any range you want. For example, if 
you want the computer to ‘‘pick a number be- 
tween 1 and 6,’’ you type 


PRINT INT (RND+6) +1 


INT (for integer) is the function under R, conven- 
iently close to RND. You have to dip into function 
mode twice to do this. Here’s what is happening: 


1. RND<+«6 is generating a decimal fraction 
between @ and 1, and multiplying it by 6. 

2. INT is rounding that number down toa 
whole number. If it’s 3.09345622, it becomes 
3. If it's 0.97888545, it becomes 0. Ifit’s 
5.8760, it becomes 5. 

3. That gives you a whole number between 0 
and 5, and you wanted one between 1 and 
6, so we add one ( + 1). This step is necessary 
because the INT function rounds down, 
not up. 


That’s a lot of trouble but, sorry, that’s the way 
itis. You probably ought to write that formula 
down somewhere, because you'll use it a lot. 


‘Picking a number between 1 and 6”’ simulates 
the roll of a die. Do it twice and you have a dice 
roll. 


RND, INT 
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The value returned by a RND function can be 
assigned to a variable— 


LET A =INT (RND+«32)+1 
—and used for all kinds of things, including 


deciding where on the screen some symbol is 
to be placed! 


One last thing: RND is actually not a true random 
number generator, but only a ‘‘pseudo-random”’ 
function. It actually gives you, one at a time, num- 
bers from a long table that has been randomly 
generated. The table is so long that you won’t 
be able to memorize it, but you can memorize 
the first few numbers, which will always be the 
same the first time you plug in the computer. 


Prove it. A couple of times, unplug it, then plug 
it in and try 


PRINT RND 
a few times. It’s the same sequence! 


To get away from the early part of this list, you 
use the RAND keyword, above the T key. When 
you first plug in the computer, or within a pro- 
gram, before any RND functions, type 


RAND 0 


When you use the 0, RAND (which stands for 
randomize) finds a place to start in the table 
based on how long your computer has been on 
(how many frames have been sent to the TV), 
which is about as random as you'll need. 
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On the other hand, if you use any number other 
than 0, RAND starts using the table at a certain _ 
point based on that number, so that 


RAND 50 


will always start RND with the same number. 
Try it out. You can amaze your friends with it. 


Summary 

1. The T/S 1500 will carry out the mathematical 
operations of + (addition), — (subtraction), 
* (multiplication), / (division) and ** (raising 
to a power). 
This can be done anytime within a program; 
in the immediate mode, you need to use a 
PRINT command to see the result. 


PRINT 2+ 2 


2. Mathematical operations are carried out ina 
particular order of priority; you can circum- 
vent the priority ranking by using parentheses. 
Operations in parentheses are executed first. 

3. The Timex Sinclair 1500 can understand 
scientific notation, and will use it with large 
numbers. 

4. The computer has a number of built-in math- 
ematical functions, which can be accessed 
with single keys in function mode. 

5. The function RND generates pseudo-random . 
numbers. 
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GOTO 


1000 REMTHE 
fo10 
1020 


Chapter Preview Recycle your program 
lines with self-contained 
subprograms, using 
GOSUB and RETURN. 


In a long program, you will sometimes need to 
repeat the same operation at two or more different 
locations within the program. 


It is a lot of extra work—and unnecessary—to 
write the same statement lines over and over each 
time such a repeating operation is needed. Instead, 
you can use the same portion of the program 
repeatedly. 


If you have a program segment you want to use 
over and over, you can direct the computer to it 
by using GOTO and the line number. At the end 
of the segment, you direct the computer some- 
where else, with another GOTO. For example: 
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10 REM THE MAIN PROGRAM 
20 

30 

40 GOTO 1000 

50 

60 

70 


1000 REM THE SUBROUTINE 
1010 

1020 

1030 

1040 GOTO 50 


But suppose you want to call that subroutine 
from several different places in the program... 
and you don't want to GOTO 50 each time when 
the subroutine is done. 


That’s what GOSUB and RETURN are for. 
GOSUB 1000 sends the computer to line 1000 
just as GOTO 1000 does. RETURN directs the 
computer to the line after the GOSUB command. 
For instance: 


10 REM THE MAIN PROGRAM 
20 

30 

40 GOSUB 1000 

50 

60 

70 GOSUB 1000 

80 

90 


1000 REM THE SUBROUTINE 
1010 

1020 

1030 

1040 RETURN 


REM, GOSUB, RETURN 
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GOSUB, RETURN 


In the program model above, the command 
RETURN, ending the subroutine, directs the com- 
puter to line 50 after the first execution (called 
by line 40) and to line 80 after the second go- 
around (called by line 70). 


GOSUB and RETURN can save work for you, 
and space in the computer’s memory. But per- 
haps more importantly, they help you organize 
your programs so that other people trying to use 
them—and you, coming back to them after a 
lapse of time—can understand how they work. 


Structured Programming 

If you hang around professional programmers, 
you'll hear a lot of talk about structured program- 
ming (and some opinions that ‘‘you can’t do 
structured programming in BASIC’’). 


There are many competing definitions of ‘‘struc- 
tured programming,” but probably the most 
common element of the definitions involves 
breaking large programs into smaller, more 
manageable modules. 


Subroutines can be those modules, in BASIC. It 
can be very helpful to try to use subroutines when- 
ever possible as you create larger programs: plan 
the overall strategy, and then use subroutines 
(and sub-subroutines within the subroutines) to 
execute specific tasks that contribute to solving 
the overall problem. 
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10 REM PROGRAM: MATH 
20 LET A = INT (RND*9) + 1 
30 LET B = INT (RND*9) +1 
40 PRINT ‘‘DO YOU WANT TO" 
50 PRINT TAB 10; ‘‘ADD—PRESS 1" 
60 PRINT TAB 10; ‘“SUBTRACT—PRESS 2” 
70 PRINT TAB 10; ‘‘MULTIPLY—PRESS 3" 
80 PRINT TAB 10; ‘‘DIVIDE—PRESS 4” 
90 INPUT D 
100 IF D< 1OR D> 4 THEN GOTO 40 
110 CLS 
120 GOSUB D+1000 
130 INPUT E 
140 PRINT AT 10,15;E 
150 IF E=C THEN PRINT AT 15,10; ‘‘CORRECT”’ 
160 IF E< > CTHEN PRINT AT 15,10; 
“SORRY, WRONG NUMBER" 
170 PRINT AT 17,10; “WANT ANOTHER— 
YORN?” 
180 INPUT A$ 
190 CLS 
200 IF A$< > ‘Y’ THEN STOP 
210 GOTO 20 
1000 LET C=A+B 
1010 PRINT AT 10,10;A;" + "5B; =?” 
1020 RETURN 
2000 LET C=A-B 
2010 PRINT AT 10,10;A;‘‘ — "5B; =?" 
2020 RETURN 
3000 LET C=A*B 
3010 PRINT AT 10,10;A;"'«"';B;" =?" - 
3020 RETURN 
4000 LET C = A/B 
4010 PRINT AT 10,10;A;‘'/"";B;‘ =?" 
4020 RETURN 


In line 100 use the keyword OR (SHIFT W), but 
in line 170 spell out the word OR. 


This example program includes a number of 
concepts we have discussed in previous chap- 
ters. It also illustrates how the use of subroutines 
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can serve to.make a program’s structure easy to 
follow. In fact, this program does not require sub- 
routines to get the job done. Why not? (We'll give 
you the answer after we call attention to a few 
of the other features of the program.) 


1. Lines 20 and 30 make use of the random 
number generator. 

2. Lines 50-80 use TAB to format an indented 
column on the screen. 

3. Lines 90, 130 and 180 use INPUT. 

4. Line 100 is an error trap which repeats the 
question if you input any character other 
than one of the choices the program can 
deal with. 

5. Line 120, instead of using 4 different lines 
with separate GOSUB addresses, uses mul- 
tiplication to select the subroutine. This 
technique can also be done with GOTO. 

6. Line 140 uses PRINT AT. 

7. Lines 150 and 160 are both necessary, unlike 
the example in Chapter Nine. Why? 

8. Line 200 STOPs the program if any other 
key than Y (for yes) is pressed, even though 
the screen asks for ‘‘Y.OR N?”’ This is be- 
cause, otherwise, inputting anything other 
than Y or N would be an error, causing the 
program to ‘‘crash.’’ Could you use an error 
trap like the one in line 100 instead? 

9. Each subroutine does a different mathemati- 
cal operation, but works on whichever random 
numbers have been generated and provides 
an answer against which the user’s answer 
is checked. 

10. Rounding errors may give you trouble in the 
division subroutine. Can you use the correc- 
tion routine in Chapter Ten to fix this? 


The answer to our question is that you could actu- 
ally use GOTO D+ 1000 for each ‘‘subroutine”’ and 
GOTO 130 instead of RETURN at the end of 
each one. 


| TAB, INPUT, STOP, PRINT AT, GOSUB, RETURN, GOTO 93 
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A Useful Subroutine 

The version of BASIC used by the Timex Sinclair 
1500 does not have READ, DATA and RESTORE 
statements. This is not a major problem, as the 
function of DATA statements can be mimicked 
in many flexible ways. Occasionally, however, 
you might wish to translate programs from a 
“dialect’’ of BASIC using the DATA statement. 


The DATA statement allows a programmer to 
define a list of numbers in a program. The READ 
statement retrieves these numbers, one at a time, 
and assigns them to a variable. The RESTORE 
statement forces the READ statement to start 
over at the beginning of the DATA list. 


Here’s a way to use a subroutine to translate a 
program which uses DATA statements: 


First, include the following subroutine in your 
program (you may have to change the line num- 
bers if you are already using these): 


500 LET DI =DI+1 

510 IF D$(Dl) = “',"" THEN GOTO 500 
520 LET DJ = DI 

530 LET DJ = DJ +1 

540 IF DJ> LEN D$ THEN GOTO 560 
550 IF D$(DJ)< > ‘',"" THEN GOTO 530 
560 LET D = VAL D§(DI TO DJ — 1) 

570 LET DI = DJ 

580 RETURN 


Then, add this line to the program, somewhere 
near the beginning (before any READ 
statements): 


LET DI=0 


Follow that with a substitute data statement 
using LET D$ = ‘‘your data’. For example, if the 
original data statement reads 


DATA 5,10.4, — 3,6.9E — 10 


ss 


T 


2. 2. 2 he he 


4 


= e] 


Chapter 11: Subroutines 


you would change it to 
LET D$ = ‘'5,10.4-3,6.9E — 10” 


Replace all RESTORE statements in the 
program with 


LET DI=0 
Next, replace all READ statements with 


GOSUB 500 
LET VARIABLE = D 


for example 
190 READ A 
would become 


190 GOSUB 500 
191 LETA=D 


(We are indebted to Dave Wood of the Sinclair/ 
Timex User Group, Boston Computer Society, 
for this routine.) 

Summary 

1. Subroutines help you use techniques of 
“structured programming’”’ in BASIC to 
make programs easier to use and 
understand. 

2. GOSUB directs the program toa specific line, 
as does GOTO, but stores the location of the 
program line containing the GOSUB. 

3. RETURN, the last line of the subroutine, directs 
the program to the next line after the GOSUB. 

4. GOSUB and RETURN must be used together, 
like FOR and NEXT. 


GOSUB, RETURN, GOTO 95 
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Chapter Preview We make pictures and 
diagrams with PLOT, 
UNPLOT and the key- 
board graphics symbols, 
and learn how to make 
things SCROLL. CODE 
and CHRS are also 
explained. 


10 REM PROGRAM: INCHWORM 
20 FORX=1TO5 

30 PLOT X,21 

40 NEXT X 

50 FOR X=5 TO 63 

60 PLOT X,21 

70 UNPLOT X — 5,21 

80 NEXT X 


The program above uses PLOT and UNPLOT to 
simulate the progress of an inchworm across the 
screen. Type it in and RUN it. 


The format of the PLOT statement is 
PLOT x, y 


with x being a number from @ to 63, from left to 
right on the screen, and y being a number from 0 
to 43, from bottom to top on the screen. 
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PLOT 0,0 


INPUT AS 
PLOT 0,43 
INPUT AS 
PLOT 63,0 

60_INPUT A$ 

7ORPLOT 63,43 


The PLOT command fills in, with a black box, the 
pixel (picture element) located by the two 
coordinates. The UNPLOT command, as you 
would guess, etases anything PLOTted at the 
indicated location. 


Here’s a program that defines the screen for the 
PLOT command, placing a square at each corner: 


10 PLOT 0,0 
20 INPUT A$ 
30 PLOT 0,43 
40 INPUT A$ 
50 PLOT 63,0 
60 INPUT A$ 
70 PLOT 63,43 


Rounding errors may give you trouble in the 
division subroutine. Can you use the correction 
routine in Chapter Ten to fix this? 


After typing in the program, press RUN and 
ENTER and the first square will be located. The 
program will wait for an INPUT before plotting 
each of the other corners—but notice, it won't do 
anything with the input. We can use INPUT this 
way as a device to make the computer wait until 
we are ready to proceed. (You can just press ENTER 
in response to the INPUT prompt.) 


You may recall we divided the screen into 32 char- 
acters while discussing the TAB and PRINT AT 
commands. It has 24 lines, but only 22 are avail- 
able to PRINT on; the bottom two are reserved for 
writing program lines. 

Multiplying those two numbers (32 and 22) by 
two gives you 64 and 44. . .and these are the 
dimensions of the PLOT screen (0-63 and 0-43). 
So you can PLOT twice as many points as you 
can PRINT, right? 


PLOT, UNPLOT, INPUT 
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Wrong! As those of you who are paying attention 
can tell, you can PLOT four times as many loca- 
tions. Here’s a diagram to explain further: 


An example: this is the pixel (57,32) 


Columns » 
012 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31, 

43 

0 2 ay 

1 40 39 

2 38 37 

3 36 36 

4 34 3, 

5 a2 

6 30 49 

7 289 5 

8 2 og 

9 24 9, 

10 22 53 

tt 20 19 
12 aa 17 A 
13 16 46 8 
14 14 123.08 
15 12 & 
nog 
16 10 9 
fe} 
17 8 7 8 
a OnE ee 
n 19 4 a 
oO 3 Oo 
& 20 ee eae | 
& ‘ 
eo 0 Ay 


05234) 6 | 8 $10;12)14316518§20/22: 24; 26 28) 30) 32; 34} 36; 38: 40; 4244246 48) 50152;54 56:58 60762 
YZ 


Pixel x-coordinates > 


‘You cannot PRINT or PLOT 
on the bottom two lines. 


You can locate the X and Y axes on the screen 
with this little program: 


REM PROGRAM: X/Y AXES 
TO 63 


ton yee To 63 
SeBNEXt 10 REM PROGRAM: X/Y AXES 
20 FORX=0TO63 
30 PLOT X,21 
40 NEXT X 


PLOT 
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50 FOR Y = 0 TO 43 
60 PLOT 32,Y 
70 NEXT Y 


And you can plot graphs of functions, such as 


10 FOR N=0 TO 


Be PLOT Ne20ssaR (N/16) this brief program that shows a part of a parabola 


3ORNEXT N 


as a graph of SOR between 0 and 4. 


10 FOR N=0TO63 
20 PLOT N,20*SOR (N/16) 
30 NEXT N 


And remember, anything you can PLOT, you can 
UNPLOT. And by the way, PLOT and UNPLOT, 
like many other commands we've seen, move the 
print position to the PLOT or UNPLOT location. 


Using Keyboard Graphic Symbols 

You can use the various keyboard graphic symbols, 
in combinations of PRINT statements, to draw 
figures on the screen. Try 


10 REM PROGRAM: GRAPHICS 
19 REN PROGRAM: GRAPHICS 20 PRINT '' ” 


30 PRINT '" y 
sett (LT: S0FRINT CT: 


50 PRINT * 


Hint: In line 20, after the first quotation marks, 
press SHIFT 9 to enter graphics mode. Press 
-SHIFT 6 five times, then press SHIFT 9 again to 
exit graphics mode and close the quotes. 


100 PLOT, UNPLOT, SHIFT 
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REM PROGRAM: GRAPHICS 
PRINT " ig? 


Oo 


INT 


60 
70BGOTO 20 


etc. 


10 SCROLL 
20 INPUT AS 
30 PRINT AS 
40coto 10 


SCROLL, TAB, PRINT AT 


In line 30, use a SHIFT 8 for the left-hand graphic 
symbol, then get out of graphics mode and type 
in three spaces. Finally, go back into graphics 
mode and type a SHIFT 5 for the right symbol. 


Line 40 repeats 30, and in line 50, you'd use the 
graphic on the 7 key. 


You can also use graphic drawings more than 
once in a program. Add, to the above program, 
the lines 


60 PRINT 
70 GOTO 20 


and RUN it. 


What would it look like without line 60? How 
about if you GOTO 30 instead? 


Can you use TAB, PRINT AT and the comma and 
semicolon to move the rectangle around the 
screen? 


Try drawing other, more elaborate figures with 
the graphic symbols. Notice how they can be 
made to fit together (even to the small difference 
between the symbols on the G and H keys). 


SCROLL 

One more interesting thing you can do with the 
screen involves the SCROLL command. SCROLL 
moves the display up one line, causing the top 
line (when there is one) to disappear off the top of 
the screen, and it moves the print position to the 
bottom of the screen. Try this: 


10 SCROLL 
20 INPUT A$ 
30 PRINT A$ 
40 GOTO 10 


When the prompt appears, type in a letter, group 
of letters, or word and then press ENTER. Keep it 
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up until the display reaches the top of the screen 
and starts SCROLLing off. 


The SCROLL command can be used to keep a 
program from stopping because the screen is full. 


This program sets up an endless loop. Can you 
stop it by pressing STOP when it asks for input? 


You can if you DELETE the left quotation mark 
before the [§ cursor. Otherwise it just treats STOP 
as another string to be dealt with. 


Other Wonders: CHRS and CODE 

eeureiyrsentes x'sunsee Fron | We talked earlier about the T/S 1500's “extended 
alphabet,” in which all its letters and numbers 
68 GoTo 48 (and even keyword commands) are ranked in a 
256-character listing. 


Each character or keyword has a CODE number 
(a number between @ and 255) and each of those 
code numbers has, of course, a character which 
ENTER A NUMBER FROM 1 TO 255 we call a CHR$ or character string (it is avery 
oe short character string. . .). 


CHR$ (using the function CHR$ located below 
the U key) applied to a number gives the single 
character string whose code is that number. 
Here’s a program to find the character when you 
know the code: 


10 REM PROGRAM: CHARACTERS 
20 PRINT ‘ENTER A NUMBER 
FROM 1 TO 255" 

30 PRINT 

40 INPUTA 

50 PRINT CHR$ A; 

60 GOTO 40 


We used 1 to 255 in line 20. Code 0 is for the 
blank space, and we could just as well have 
included it. 


Each time you input a number between 1 and 
255, you are shown the corresponding character. 


102 SCROLL, CODE, CHRS$ 


Chapter 12: Graphics and Other 


Wonders 


REM PROGRAM: CODES ; 
°20 PRINT "PRESS ANY KEY" 
30 PRINT 

40_INPUT AS 

SOBPRINT cooE AS 


60 GOTO 4 


PRESS ANY KEY 


62 
220 
190 
134 
213 


yg 


PLOT, UNPLOT, SCROLL 


In many cases, you'll be shown a question mark; 
this is what the computer will put on the screen if 
it does not have a symbol it can print for that 
number. 


Notice the semicolon at the end of line 50; feel 
free to change it if you like. 


Here's one way to go the other way: input a 
character from the keyboard, and get its code. 
Use the function CODE located below the I key. 


10 REM PROGRAM: CODES 
20 PRINT ‘PRESS ANY KEY”’ 
30 PRINT 

40 INPUT A$ 

50 PRINT CODE A$ 

60 GOTO 40 


In the sample run, we've obtained the code for, 
respectively, 


Y 

SHIFT Y 
GRAPHICS Y 
GRAPHICS SHIFT Y 
FUNCTION Y 


Summary 

1. PLOT places a black square in a pixel (picture 
element) defined by two numbers separated 
by a comma: 0-63 from left to right across the 
screen and 0-43 from bottom to top. 


PLOT 63,43 


2. UNPLOT uses the same coordinates to erase 
any previous PLOT marking. 

3. Keyboard graphic symbols can be combined 
into charts and pictures. 

4. SCROLL moves the display up one line (elim- 
inating the top line, if any) and places the 
PRINT position on the bottom line. 
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5. CHR$, applied to a number between 0 and 
255, returns the character whose code is that 
number. 


PRINT CHR$ 140 


| 


6. CODE, applied to a single character string, 
returns the code number for that character. 


PRINT CODE A$ 
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How 
obtained 


Ejor 
SPACE 


iG 
shifted 1 
Gg 
shifted 2 
|G 
shifted 7 
iG 
shifted 4 
|G 
shifted 5 


iG] 
shifted T 

iG 
shifted E 

g 
shifted A 


shifted D 


|G 
shifted S 


Here are the 22 graphic symbols. 


Code Symbol How’ 
obtained 
SPACE 
shifted 0 
shifted W 
shifted 6 
shifted R 
shifted 8 
shifted Y 
shifted 3 
shifted H 
9 LG 
shifted G 
shifted F 


Code 


128 


129 


130 


131 


132 


133 


134 


135 


136 


137 


138 


105 


th ee 


"Matters of Timing 13 


Chapter Preview This chapter shows 
you how to make things 
move with INKEYS, stop 
for a while with PAUSE, 
and how the computer 
works in FAST or SLOW 
mode. 


S\ 
10 REM PROGRAM: TAG 


20 LET X= 11 
30 LET Y = 15 
40 LETA=0 
50 LET B=0 
60 PRINT AT X.Y; 
70 PRINT AT A,B; ‘E8” 
teed 80 LET C= INT (RND+4) + 1 
W\\ = 90 IF C =1 THEN LET X =X +3 
100 IF C=2 THEN LET X=X-3 
110 IF C=3 THEN LET Y =Y +3 
Y 1201IF C=4THEN LET Y=Y-3 
130 IF INKEY$ = ‘5: THEN LET B=B-1 
140 IF INKEY$ = ‘6’ THEN LET A=A+1 
150 IF INKEY$ = ‘7 THEN LET A=A-1 
160 IF INKEY$ = 8" THEN LET B=B+1 
170IFA<®ORB<0ORX<0ORY<QORA>21 
OR B>31O0RX>210RY>31 THEN STOP 
180 IF A =X AND B= Y THEN STOP 
190 CLS 
200 GOTO 60 
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The command INKEY$ is like INPUT except that 


Bd it does not wait for you. INKEY$ scans the keyboard 
to see which key is being pressed—if any—and 
i takes action according to the program. 


The above program is a game of tag. Lines 20-70 
place a black square in the center of the screen 
(to get a black square, press the SPACE key while 
in graphics mode—the black square is the inverse 
of the white space) and put you in control of a 
grey square (graphic H) in the upper left hand 
corner. 


Lines 80-120 use a random number generator to 
move the black square, three spaces at a time in 
any direction. 


Lines 130-160 move the grey square, according 
to your direction. You can only move one space 
at a time, but presumably you are moving 
purposefully. 


Line 170 stops the program (and you lose) if the 
black square escapes to the edge of the screen— 
or if your grey square falls off the edge! 


Line 180 stops the program (and you win) if you 
“tag’’ the black square with your grey one; that 
is, if their coordinates are the same. 


When you play this game, remember that INKEY$ 
checks the keyboard to see what key is being 
pressed when that program line comes by. Rather 
than tapping the keys, you ought to hold down the 
key that corresponds to the direction you wish to 
move to close in on the black square. 


Notice, also, that you use the four cursor arrow 
keys to move in the direction of the arrow, but 
you don't have to press SHIFT. 


If you are having trouble winning, try changing 
lines 40 and 50 so you start out closer to the black | 
square... 
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1@ SCROLL 
20_PRINT INKEY$ 
30BGoTo 10 


10 SCROLL 
20 PRINT INKEYS 
25_PAUSE 60 
30BcoTo 10 
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Here’s a short program to show that INKEY$ waits 
for no one. If you don’t type a character (press any 
key) very quickly, the computer prints a blank 
space and scrolls merrily onward and upward. 
Use the BREAK key when you want to stop it. 


10 SCROLL 
20 PRINT INKEY$ 
30 GOTO 10 


PAUSE 

The PAUSE command does just what you'd 
expect it to, and you can set it using a numerical 
value. 


PAUSE 60 is about one second. More is a higher 
number and less is lower. Add to the above pro- 
gram: 


25 PAUSE 60 


| and it will be a lot easier to keep up with the 


scrolling. 


Here is a diabolical program that changes the 
length of PAUSE in response to your success at 
the game! Your task is to ‘‘echo”’ the computer's 
output on the screen. When the computer prints 
a random digit between @ and 9, you have to type 
that digit before the computer goes on to the 
next one. 


The good news is that, if you miss some, the 
computer will slow down for you. The bad news 
is that, if you get some right, the pace will speed up. 
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10 REM PROGRAM: ECHO 
20 LET T = 60 
30 LET A$ = CHR$ INT (RND«10 + CODE ''0’’) 
40 PRINT A$ 
50 PAUSE T 
60 LET B$ = INKEY$ 
70 IF B$ = A$ THEN GOTO 100 
80 LET T = T«1.1 
90 GOTO 30 
100 LET T=T+0.9 
110 GOTO 30 


1@ REM PROGRAM: ECHO 
20 LET T=68 
3@ LET AS=CHRS INT (RND*16+COO 


gE many 
4@ PRINT AS 

5@ PAUSE T 

68 LET BS=INKEYS 

7@ IF BS=A$S THEN GOTO 160 

8@ LET T=T#1.1 


108 LET T=T#8.9 
410BsoTo 30 


SLOW and FAST 

The Timex Sinclair 1500 has two speeds, SLOW 
and FAST. Normally it runs in the SLOW mode, 

which is fast enough for most purposes and has 
the advantage of maintaining the screen for the 
use of graphics. 


What happens in the SLOW mode is that the 
computer maintains the screen display and does 
its computing between ‘‘screen refreshes’’— 
during the period when the television is produc- 
ing the black line you see between frames when 
the vertical hold slips. 


When you have lengthy computation to be done, 
you may want to slip into FAST mode. Roughly 
four times as fast, this mode computes first and 
puts a picture on the screen only when it is not 
otherwise occupied. This results in periods of 
grey screen during long calculations, and even 
brief flickers when entering characters from the 
keyboard. 


You can put the commands SLOW and FAST into 
programs, directing the T/S 1500 to use the most 
appropriate mode for what it has to do. You can 
also press FAST outside of a program and the 
computer will stay in FAST mode until you press 
SLOW. 
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10 FOR N=0 TO 703 
20 PRINT "T"; 
3OBNEXT N 
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Try typing in this program: 


10 FORN =0 TO 703 
20 PRINT ‘'T"’; 
30 NEXT N 


Press SLOW (SHIFT D) just to make sure you are 
in that mode, then RUN the program and time it. 
Then press FAST (SHIFT F) and RUN and time 
the program again. Pretty impressive, eh? 


Summary 

1. INKEY$ reads the keyboard and inputs as a 
character string any key being pressed. If no 
key is being pressed at the time, it “‘reads’”’ 
the empty or ‘‘null string.’’ PRINT INKEY$ 
will then act like PRINT alone; if no key is being 
pressed, the computer will print a blank line. 


2. PAUSE causes a program to wait a specified 


length of time (60 = one second) before con- 
tinuing to the next line. If a key is pressed, the 
pause ends. 

3. SLOW, the mode in which the computer nor- 
mally runs, gives priority to maintaining the 
screen display. 

4. FAST, which can be obtained by a program 
statement or a separate command, gives prior- 
ity to computation and runs about four times 
as fast as SLOW. 
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Chapter Preview 


22 


29 


An array is a way of structuring a number of values 
and keeping track of them. Each of the values is 
called an element of the array. You can think of 
an array as looking like a calendar: 


SUN MON TUES WED THU FRI SAT 


2 


9 


16 


23 


30 


Organize your data 
and save space with 


_ - “arrays,” using DIM, 


subscripts, and string 
slicing. 


ane | ee 
17 18 19 
24 | 25] 26 


=| 
=a 
0) 
p 
R 
a 
< 


An element 
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Array A(5) 
(1) (2) (3) 4) 6) 


rays] a4 


You can assign numeric values to elements of an | 
array, instead of giving each value a separate var- 

jiable name. This can be used simply to save space, 
or when there is a relationship between or among 
the values. 


Suppose you have a row of numbers: 

12 5 7 22 14 

You could assign the values to separate variables 
LET A=12 

LET B=5 

LET C=7 


LET D = 22 
LET E= 14 


Or, you can consider the whole row to be an array: 


LET A(1) = 12 
LET A(2)=5 
LET A(3) =7 
LET A(4) = 22 
LET A(5) = 14 


The number in parentheses is called the 
subscript. 


Picture the array this way: 


DIM. . . The Dimension Statement 

Before you can assign values to each element in 
the array, you have to reserve space for the array 
with a dimension statement (DIM). To prepare for 
the array above, you would have to enter 


DIM A\(5) 


LET, DIM 
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DIM 


There are a few rules regarding array variables: 


1. An array variable name must be a single letter: 
(like a control variable in a FOR/NEXT loop). 

2. An array variable name can be the same as 
the name of a simple variable (there can be 
a simple variable named A at the same time 
as an array named A; you can tell them apart 
because elements of the array variable are 
always referred to with the subscript). 

3. ALET statement erases a previous simple 
variable by the same name. Similarly, when 
you create an array with the DIM statement, 
you delete any previous array of the same name. 
But while you can build a new simple variable 
from an old one (as in LET A = A+ 1), you would 
simply lose an old array by DIMensioning a 
new one by the same name. 


Arrays in More Than One Dimension 
You can have arrays of as many dimensions as 
you care to try to keep track of, as long as you 
dimension them properly at the outset: 


DIM A@,5) 


would set up an array you can think of as looking 
like this. 


You can think of the first number as identifying 
the row and the second, the column. Therefore, 
location # in the diagram is A(3,5). 


What value occupies the location (3,5) in our 
calendar? 
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You can have an array in three dimensions; think 
of it as looking like this: 
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DIM A(5,5,5) 


And you can have arrays in four or more dimen- 
sions, but don’t ask us to help you picture them. 


String Arrays 
You can assign strings to arrays, as 


DIM A$(5,5) 


but there are a few rules here, too. 


a 


When you DiIMension the string array, you 
delete any previous string arrays and any 
previous simple string variables that have the 
same variable name. 
In two dimensions, you can think of the first 
number as being the identifier of each string, 
or “word,” and the second as the number of 
letters in each word. 
Assignment to the string variable elements is 
Procrustean, which means that the strings are 
filled in from character #1 up through a number 
of characters equal to the second subscript, and 
a. If the string is too long, it will be truncated 
from the end. 
b. If the string is too short, the space will be 
filled in with blanks. 


DIM 


4 { 4 
i i 


4 i 4 
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Array A$(5,5) 

You access the strings by using the first subscript 
only, and individual letters by using the second 


subscript as well. 


PRINT A$(3) returns DIAMO 


(the ND are truncated), and 


PRINT A$(4) returns CLUB 
(including a blank space after the B). Also, 
PRINT A$(3,2) returns I 


PRINT A$(4,5) returns the blank space 


You can also use string slicing (more about that 
in a moment) to obtain a portion of a string, as 


PRINT A$(4,2 TO 4) returns LUB 
PRINT A$(3, TO 3) returns DIA 


String Arrays in Three of More Dimensions 
You can have string variable arrays in as many 
dimensions as you like. However many numbers 
(dimensions) are separated by commas, the Jast 
number identifies the number of characters in each 
string, and the other numbers serve to specify the 
string by its location. In three dimensions: 
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ONES AND TWOS 
ONES AND TWOS 
A 

ONES 

ONES 

Twos 

Twos 


PRINT A$(3,5,5) would return WHEEL in the array 
diagrammed below. 


Again, it is not easy to picture string arrays in 
more than three dimensions, but just remember 
that the last subscript specifies the number of 
characters in each string in the array, while the 
other subscripts locate the string. 


Slicing Strings 
Running the program 


10 LET A$ = “ONES AND TWOS"’ 
20 PRINT A$ 

30 PRINT A$ ) 

40 PRINT A$(6) 

50 PRINT A$(1 TO 4) ° 

60 PRINT AS$(TO 4) 

70 PRINT A$(10 TO 13) 

80 PRINT A$(10 TO) 


demonstrates string slicing. Line 20 prints the 
string. Line 30 shows the empty brackets after the 
string variable name means that the entire string 
is its own substring. 


Line 40 selects, as a substring, only one character 
—the sixth (don't forget to count the spaces in 
the string). 


SS q 1 


Chapter 14: Arrays AS 1 eee 


DIM 


| Line 50 prints characters 1 to 4 of the string; line © 


60 shows that you can omit the first digit and the 
first character is implied. Line 70 shows how to 
print the last four characters, and line 80 shows 
that you can omit the last number and ‘“‘last char- 
acter’’ is implied. 


How would you print “AND” out of that string? 


Now, we can use string slicing to save space in 

a program by assigning a long string to a variable 
name and then cutting pieces out of it, rather than 
assigning a lot of variables. (If you use this tech- 
nique with numbers and want to perform mathe- 
matical operations with them, you need to use the 
VAL function. See Appendix A.) 


Summary 

1. An array is made up of a number of elements, 
all with the same array variable name, and 
distinguished from each other by means of 
subscripts. 

2. The name of a numeric array must be a single 
letter; there can also be a simple variable using 
the same letter as a name. 

3. The name of a string variable must be a single 
letter followed by $; there cannot be a simple 
string variable with the same name in the 
computer's memory. 

4. Before assigning values to the elements of 
an array, you must reserve space for it in the 
computer with the DIM statement. 

5. You can ‘‘slice’’ strings and obtain substrings 
by using the TO statement. 
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LPRINT, LLIST 
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Chapter Preview You can get programs or 
output on paper with 
LPRINT, LLIST, and 
COPY if you havea 
printer. 


10 REM PROGRAM: PRINTER 

20 LPRINT ‘THIS PROGRAM"’,,,, 

30 LLIST 

40 LPRINT 

50 LPRINT ‘‘PRINTS OUT THE 
CHARACTER SET.”’,,, 

60 FOR N = 0 TO 255 

70 LPRINT CHR$ N; 

80 NEXT N 


You can obtain copies of your programs, and their 
results, on paper, by attaching a printer to your 
Timex Sinclair 1500. This is called a ‘‘hard copy”’ 
because it will be around for a while, as opposed 
to what you see on your screen. 


Run the program above, with the Timex printer 
attached. Notice that it prints a listing of itself, 
and the T/S 1500's character set. 
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a MES 270) ><=4+-*/3,.0123 
456789ABCDEFGHIJKLMNOPQRSTUVWXYZ 


/;,-01234567 
Sseeahee4""AT TAB ?CODE VAL LEN SI 
N COS TAN ASN ACS ATN LN EXP INT 
SQR SGN ABS PEEK USR STR$ CHRS 
NOT ** OR AND <=>=<> THEN TO STE 
P LPRINT LLIST STOP SLOW FAST NE 
W SCROLL CONT DIM REM FOR GOTO G 
OSUB INPUT LOAD LIST LET PAUSE N 
EXT POKE PRINT PLOT RUN SAVE RAN 
D IF CLS UNPLOT CLEAR RETURN COP 
Y 


The Timex printer is an inexpensive device 
that attaches to the back of your 1500 and is then 
operated by just three simple commands. 


LPRINT 

LPRINT (SHIFT S), is the same as PRINT, except 
that the material to be printed is sent to the printer 
instead of the screen. 


The ‘‘L” originally stood for “‘line printer,” although 
the command is now used for any kind of “hard 
copy”’ printer. When BASIC was invented, the 
usual display was a kind of electric typewriter 
rather than a TV screen, so PRINT really did mean 
print. If you wanted a lot of output fast, a line 
printer would turn it out more quickly than a 
character-at-a-time typewriter. 


LLIST 

In the same way, LLIST (SHIFT G), lists the pro- 
gram currently in the computer’s memory on the 
printer instead of the screen. 


LLIST can be used to ‘‘pull a listing’ without put- 
ting a program line in front of the command. If 

you add a program line—as in LLIST 9@—the list- 
ing will be printed starting with that line. In other 


LPRINT, LELIST 
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words, if you know you want a copy of the program 
the computer has in it, just press LLIST and 
ENTER, and you'll get it. 


Or, LLIST can be used within a program like the 
one above—now is a good time to try it out, if 
you haven’t already. 


(LPRINT, of course, can also be used either way. 
Usually, you'll use LPRINT within a program— it 
needs to LPRINT ‘““SOMETHING’’—while you'll 
more often use LLIST outside the program, just to 
get a copy of it to refer to.) 


COPY 

The third printer command is COPY (keyword 
over Z). This simply makes a copy, on the printer, 
of whatever is on the screen when COPY is pressed. 
You can use COPY as a program line or as a sep- 
arate command anytime you want to copy the 
screen. 


Try this program, which graphs the function SIN 
(resulting in a sine wave.) 


10 REM PROGRAM: SINEWAVE 
20 FOR N=0TO63 

30 PLOT N,22 + 20+SIN (N/32*PI) 
40 NEXT N 

50 COPY 


(In line 30, PI is not spelled out—use the function 
m under the M key.) 


Questions: 

Will you get the same effect by eliminating line 50, 
and then pressing COPY and ENTER after the 
program has stopped running? 


Why do you use the range @ to 63 for N in line 20? 


Will you get the same effect by pressing LLIST 
and ENTER as you get by using ENTER to get the 
program listing on the screen and then pressing 


COPY and ENTER? 
LLIST, COPY, SIN 123 
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Stopping the Printer with BREAK 
When the printer is running, you can stop it 
with BREAK. You might want to save paper if, for 
example, you are using COPY to print out the five 
line program listing above. The command will 
run out all 24 lines’ worth of paper, unless you 
press BREAK when you see line 50 appear. 


If you try to execute any of the three printer 
commands without a printer attached, usually the 
program will just proceed to the next line without 
printing anything. Sometimes, however, the com- 
puter will get hung up and you'll need to press 
BREAK to rescue it. 


Print Format Statements with the Printer 
All but one of the screen printing format com- 
mands will work with LPRINT. The comma, 
semicolon, and TAB can be used, but AT does 
not work. To illustrate, try this: 


selleen procean: cerrens, 10 REM PROGRAM: LETTERS 
ome aT STN NSCHRS (CODE 20 FOR N = 31 TO 0 STEP = 1 
mee 30 PRINT AT 31 — N,N;CHR$(CODE “0” +N); 


40 NEXT N 


v | RUN the program. You'll see a diagonal row of 
ru letters working its way down the screen, until it 
@ stops with report code 5: the screen is full. 
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REM PROGRAM: Aa 
20 FOR N=31 TO 
3OBPRINT TAB ON; cus Ceove nee 


oe NEXT N 


Hh REM PROGRAM: LETTERS 
20 FOR N=31 TO @ STEP -1 
i. ZeRLPriny TAB N;CHRS (CODE "@" 
N 


40 NEXT N 


10 REM PROGRAM: ee 4 
ag FOR N=31 TO @ STEP 
LPRINT AT 21-N,N; tHas (CODE 


te next N 


0123456789ABCDEFGHIJKLMNOPQRSTUV 


LPRINT, TAB 


Next, change AT 31 — N,N in line 30 to TABN. 
RUN it again and you'll get the same effect. 


Be patient, we'll get to the point. 


Now, change PRINT in line 30 to LPRINT. The 
program will RUN, and the pattern will continue 
for ten more lines since the printer can't be ‘‘full’’ 
as the screen can. You’ll get no report code 5. 


Finally, change TAB N to AT 21 —N,N. RUN the 
program one more time. 


This time the printer shows a single row of char- 
acters! This is simply because AT does not send 
a ‘‘line feed”’ to the printer. It will move the print 
position over a column, but not down a line. 
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The printer will print a line 


1. After an LPRINT statement that does not end 
in a comma or semicolon. 

2. When a comma or TAB statement requires a 
new line to be started. 

3. Atthe end of a program, if there is anything 
“eft over” to be printed. 

4. Any time the ‘buffer’ is full. The buffer is the 
area where characters to be printed are stored 
until they are printed. The buffer is exactly 
one line (32 characters) long, so unless one of 
the events above (1, 2 or 3) occurs first, the 
printer will print a line when a full line is in 
the buffer (among other things, it needs to 
empty the buffer before new characters can 
be stored there). 


Remember how the printer, in the first program 
of the chapter, seemed to hesitate before printing 
each line of the character set? It was filling the 
buffer to a full line during those pauses. 


Summary 

1. LPRINT prints on the printer just like PRINT 
prints on the screen. 

2. LLIST sends a program listing to the printer 
just as LIST sends it tothe screen. 

3. COPY duplicates on the printer whatever is 
showing on the screen. 

4. BREAK stops the printer when it is running, 
or interrupts printer commands when they 
cause a problem. 

5. TAB, comma and semicolon can be used to 
format LPRINT statements, but AT does not. 
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of T/S 1500 BASIC 


(i) 


General 
If you already know BASIC then you should not have 
much trouble using the T/S 1500. 


Words are not spelled out, but have keys of their 
own—this is described in Chapter 2. In the text, 
these words are printed in BOLD TYPE. 

Sinclair BASIC lacks READ, DATA and RESTORE 
(but see Chapter 11 concerning this), user-defined 
functions (FN and DEF; but VAL can sometimes 
be used), and multi-statement lines. 

The string handling facilities are comprehensive. 
The T/S 1500 character set is completely its own. 
The television display is not, in general, memory- 
mapped. 

If you are accustomed to using PEEK and POKE 
on a different machine, remember that all the 
addresses will be different on the T/S 1500. 
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Speed 
The machine works at two speeds, called compute 
and display mode and fast mode. 


In compute and display, the TV screen is generated 
continuously, and computing is done during the 
blank parts at the top and bottom of the picture. 


In fast mode the television picture is turned off during 
computing and is displayed only at the end of a pro- 
gram, while waiting for INPUT data, or during a pause 
(see PAUSE). 


Fast mode runs about four times as fast and should be 
used for programs with a lot of computing as opposed 
to output, or when typing in long programs. 


Switching between speeds is done with the FAST and 
SLOW statements (q.V.). 


The keyboard 

T/S 1500 characters comprise not only the single sym- 
bols (letters, digits, etc.), but also the compound 
tokens (keywords, function names, etc.; these are 
printed here in BOLD TYPE), and all are entered from 
the keyboard rather than being spelled out. To fit this 
in, some keys have up to five distinct meanings, given 
partly by shifting the keys (i.e., pressing the SHIFT 
key at the same time as the required one) and partly 
by having the machine in different modes. 


The mode is indicated by the cursor, an inverse video 
letter that shows where the next character from the 
keyboard will be inserted. 


Eg mode (for keywords) occurs automatically when 
the machine is expecting a command or program line 
(rather than INPUT data), and from this position on 
the line it knows it should expect a line number or a 
keyword. This is at the beginning of the line, or just 
after some digits at the beginning of the line, or just 
after THEN. If unshifted, the next key will be inter- 
preted as either a keyword (these are written above 
the keys) or a digit. 


mode (for letters) normally occurs at all other times. 
If unshifted, the next key will be interpreted as the 
main symbol on that key. 
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In both [J and f§ modes, a shifted key will be inter- 
preted as the subsidiary black character in the top 
right-hand corner of the key. 


mode (for functions) occurs after FUNCTION (shifted 
ENTER) is pressed and lasts for one key depression 
only. That key will be interpreted as a function name, 
which appears under the keys. 


mode for graphics occurs after GRAPHICS (shifted 
9) is pressed and lasts until it is pressed again. An 
unshifted key will give the inverse video of its [J mode 
interpretation. A shifted key will as well, provided that 
it is a symbol; but if the shifted key would normally 
give a token, in graphics mode it will give the graphics 
symbol that appears in the bottom right-hand corner 
of the key. 


The screen 

This has 24 lines, each 32 characters long, and is 
divided into two parts. The top part is at most 22 lines, 
and displays either a listing or program output. The 
bottom part, at least two lines, is used for inputting 
commands, program lines and INPUT data, and also 
for displaying reports. 

Keyboard input: this appears in the bottom lines of 
the screen as it is typed, each character (single sym- 
bol or compound token) being inserted just before the 
cursor. The cursor can be moved left with @ (shifted 
5) orright with » (shifted 8). The character before 
the cursor can be removed with DELETE (shifted 0) 
(Note: the whole line can be deleted by typing EDIT 
(shifted 1) followed by ENTER.) 


When ENTER is pressed, the line is executed, entered 
into the program, or used as INPUT data as appropri- 
ate, unless it contains a syntax error, in which case 
the symbol J appears just before the error. 
As the program lines are entered, a listing is displayed 
in the top half of the screen. The last line to be entered 
is called the current line and is indicated by the 
symbol f, but this can be changed by using the keys 
~ (shifted 6)and . (shifted 7). If EDIT (shifted 1) 
is pressed, the current line is brought down to the 
bottom part of the screen and can be edited. 


When a command is executed or a program run, 
output is displayed in the top half of the screen and 
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remains until a program line is entered, or ENTER is 
pressed with an empty line, or » or # is pressed. 
In the bottom part appears a report of the form m/n, 
where m is a code showing what happened (see Re- 
port Codes), and n is the number of the last line exe- 
cuted—or Q for a command. The report remains 
until a key is pressed (and indicates [fj mode). 


In certain circumstances, the SPACE key acts as a 
BREAK, stopping the computer with report D. This is 
recognized 


(i) at the end of a statement while a program is 
running, 
(ii) while the computer is looking for a program on 
tape, or 
(iii) while the computer is using the printer (or by 
accident trying to use it when it is not there). 


The BASIC 

Numbers are stored to an accuracy of 9 or 10 digits. 
The largest number you can get is about 1098, and the 
smallest (positive) number is about 4*10 — 99. 


A number is stored in the T/S 1500 in floating-point 
binary with one exponent e(1 < = e < = 255), and four 
mantissa bytes m(1/2< = m<1). This represents the 
number m+2°— 128. 


Since 1/2< = m<1, the most significant bit of the 
mantissa m is always 1. Therefore in actual fact we 
can replace it with a bit to show the sign: 0 for posi- 
tive numbers, 1 for negative. 


Zero has a special representation in which all 5 bytes 
are 0. 

Numeric variables have names of arbitrary length, 
starting with a letter and continuing with letters and 
digits. Spaces are ignored. 

Control variables of FOR-NEXT loops have names a 
single letter long. 


’ Numeric arrays have names a single letter long, which 


may be the same as the name of a simple variable. 
They may have arbitrarily many dimensions of arbi- 
trary size. Subscripts start at 1. 


Strings are completely flexible in length. The name of 
a string consists of a single letter followed by $. 
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String arrays can have arbitrarily many dimensions of 
arbitrary size. The name is a single letter followed by 
$ and may not be the same as the name ofa string. 
All the strings in a given array have the same fixed 
length, which is specified as an extra, final dimension 
in the DIM statement. Subscripts start at 1. 

Slicing: Substrings of strings may be specified by 
using slicers. A slicer can be 

(i) empty or 

(ii) a numerical expression or 


(iii) an optional numerical expression TO optional nu- 
merical expression and is used in expressing a 
substring either by 

(a) string expression (slicer) 
or by 

(b) string array variable (subscript, ..., subscript, slicer) 
which means the same as 
string array variable (subscript, ..., subscript)(slicer) 


In (a), suppose the string expression has the value s$. 
If the slicer is empty, the result is s$ considered as a 
substring of itself. If the slicer is a numerical expres- 
sion with value m, the result is the mth character of s$ 
(a substring of length 1). 

If the slicer has the form (iii), suppose the first numen- 
cal expression has the value m (the default value is 1), 
and the second, n (the default value is the length of s$). 


If 1< =m< =n< = the length of s$, the result is the 
substring of s$, starting with the mth character and 
ending with the nth. 


If@<=n< mM, the result is the empty string. Otherwise, 
error 3 results. 


Slicing is performed before functions or operations are 
evaluated, unless brackets dictate otherwise. 


Substrings can be assigned to (see LET). 


The argument of a function does not need brackets if 
it is a constant or a (possibly subscripted or sliced) 
variable. 
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Function 


NOT 
132 


Type of 
operand 


(x) 

number 
number 
binary 
operation, 
right oper- 
and always 
a number. 
Numeric 


left 
operand: 


String left 
operand: 


number 
number 


number 


string 


number (in 
radians) 


number. 


none 


number 
string 
number 


number 


Result 


Absolute magnitude. 


Arccosine in radians. Error A if x not in the range — 1 
to +1. 


A if B40 
AANDE © fob =0 
A$ AND B = gereet 


Arcsine in radians. Error A if x not in the range —1to +1 
Arctangent in radians. 


The character whose code is x, rounded down to the 
nearest integer. Error B if not in the range 0 to 255. 


The code of the first character in x (or 0 if x is empty 
string.) 


Cosine. 


ee 


Reads the keyboard. The result is the character repre- 
senting (in [J mode) the key pressed if there is exactly 
one, else the empty string. 


Integer part (always rounds down). 
Length. 
natural logarithm (to base e). Error A if x< = 90. 


O0ifx #0, 1ifx = 0. NOT has priority 4. 
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Function Type of Result 
operand 

OR binary AORB = ceniae 

operation, ee 
both OR has priority 2. 
operands 

numbers 

PEEK number The value of the byte in memory whose address is x 
(rounded to the nearest integer). Error B if x not in the 
range @ to 65535. 

PI none Tt (3.14159265.. .) 

RND none The next pseudo-random number y in a sequence 
generated by taking the powers of 75 modulo 65537, 
subtracting 1 and dividing by 65536. 0< = y<1. 

SGN number Signum: the sign (— 1, 0 or + 1) of x. 

SIN number Sine. 

(in radians) 

SOR number Square root. Error B if x <@. 

STRS number The string of characters that would be displayed if x 
were printed. 

TAN number Tangent. 

(in radians) 

USR number Calls the machine code subroutine whose starting 
address is x. On return, the result is the contents of 
the bc register pair. 

VAL string Evaluates x (without its bounding quotes) as a numer- 
ical expression. Error C if x contains a syntax error, or 
gives a string value. Other errors possible, depending 
on the expression. 

_ number Negation. 

The following are binary operations: 

+ Addition (on numbers), or concatenation (on strings) 

= Subtraction 

* Multiplication 
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Division 

Raising to a power. Error B if left operand is negative. 
Equals 

Greater than 

Less than 

Less than or equal to 

Greater than or equal to 

Not equal to 


AVAAV WES 
+ 


vu 


Both operands must be of the same type. The result isa 
number, 1 if the comparison holds, and 0 if it does not. 


Functions and operations have the following priorities: 
Operation Priority 


Subscribing and slicing 12 
All functions except NOT and unary minus 11 
+e 10 
Unary minus 

*,/ 

+,-— (binary —) 

=,> <<=,> =,<> 
NOT 

AND 

OR 


NwWHhOIDWOO 


Statements 

In this list, 

@ represents a single letter 

Vv represents a variable 

X,Y,Z represents numerical expressions 

m,n represents numerical expressions that are 
rounded to the nearest integer 

e represents an expression 

f represents a string-valued expression 

s represents a statement 


Note that arbitrary expressions are allowed everywhere. 
(except for the line number at the beginning of a 
statement). 


All statements except INPUT can be used either as 
commands or in programs (although they may be 
more sensible in one than the other). 
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Summary of T/S 1500 BASIC 


CONT 


COPY 


DIM @ (n,,...,m,) 


DIM@ §$ (n,,....n,) 


FAST 


FOR@ =xTOy 


FOR@ =x TO y STEP z 


Result 


Deletes all variables, freeing the space they occupied. 


(CLear Screen) Clears the display file. See Chapter 26 
concerning the display file. 


Suppose a/b were the last report with a non-zero. 
Then CONT has the effect 

GOTO bifa#9 

GOTO B+1ifa = 9 (STOP statement) 


Sends a copy of the display to the printer, if attached; 
otherwise does nothing. Report D if BREAK pressed. 


Deletes any array with the name @ and sets up an 
array of numbers with k dimensions n,,,...,n,. Initial- 
izes all the values to @. Error 4 occurs if there is no room 
to fit the array in. An array is undefined until it is 
dimensioned in a DIM statement. 


Deletes any array or string with the name @ $ and sets 
up an array of characters with k dimensions nj, ..., Ny. 
Initializes all the values to ‘‘”’. This can be considered 
as an array of strings of fixed length n,, with k— 1 
dimensions nj, ..., Ny. 


Error 4 occurs if there is no room to fit the array in. 
An array is undefined until it is dimensioned ina DIM | 
statement. 


Starts fast mode, in which the display file is displayed 
only at the end of the program, while INPUT data is 
being typed in, or during a pause. 


FOR@ =xTOy STEP 1 


Deletes any simple variable and sets up a control vari- 
able with value x, limit y, step z, and looping address 
1 more than the line number of the FOR statement 

(- 1 if it is acommana). Checks if the initial value is 
greater (if step > =) or less (if step <@) than the limit, 
and if so, then skips to statement NEXT@ at the 
beginning of a line. See NEXT@. 


Error 4 occurs if there is no room for the control 
variable. 
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Summary of T/S 1500 BASIC 


Function Type of 
operand 


GOSUB n 


GOTOn 


IF x THEN s 


INPUT v 


LETv =e 


LIST 


LIST n 


LLIST 


LLIST n 
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Result 


Pushes the number of the GOSUB statement onto a 
stack; then as GOTO n. 


Error 4 can occur if there are not enough RETURNs. 


Jumps to line n (or, if there is none, to the first line 
after that). 


If x is true (non-zero), then s is executed. 
The form ‘IF x THEN line number’ is not allowed. 


Stops (with no special prompt) and waits for the user 
to type in an expression; the value of this is assigned 
to v. In fast mode, the display file is displayed. INPUT 
cannot be used as a command; error 8 occurs if you try. 
If the first character in the INPUT line is STOP, the 
program stops with report D. 


Assigns the value of e to the variable v. 
LET cannot be omitted. 


A simple variable is undefined until it is assigned to in 
a LET or INPUT statement. 


If v is a subscripted string variable, or a sliced string 
variable (substring), then the assignment is Procrus- 
trean: the string value of e is either truncated or filled 
out with spaces to the right, to make it the same 
length as the variable v. 


LIST 0 


Lists the program on the TV screen, starting at line n, 
and makes n the current line. 


Error 4 or 5 if the listing is too long to fit on the screen; 
CONT will do exactly the same again. 


LLIST Q 


Like LIST, but using the printer instead of the 
television. 


Should do nothing if the printer is not attached. 
Stops with Report D if BREAK is pressed. 


Appendix A: 
Summary of T/S 1500 BASIC. 


| oi 


Function Type of Result 


LOAD f Looks for a program called f on tape and loads it and 
its variables. If f = ‘‘’’, then loads the first program 
available. 


If BREAK is pressed, then 


(i) ifno program has yet been read in from tape, stops 
with report D and old program; 

(ii) if part of a program has been read in, then 
executes NEW. 


LPRINT... Like PRINT, but using the printer instead of the televi- 
sion. A line of text is sent to the printer 


(i) when printing spills over from one line to the next, 

(ii) after an LPRINT statement that does not end ina 
comma or semicolon, 

(iii) when a comma or TAB item requires a new line, or 

(iv) at the end of the program, if there is anything left 
unprinted. 


In an AT item, only the column number has any 
effect; the line number is ignored. An AT item never 
sends a line of text to the printer. There should. be no 
effect if the printer is absent. 


Stops with report D if BREAK is pressed. 


NEW Restarts the BASIC system, deleting program 
and variables and using the memory up to but not 
including the byte whose address is in the system 
variable RAMTOP (bytes 16388 and 16389). 


NEXT@ (i) Finds the control variable @. 

(ii) Adds its step to its value. 

(iii) If the step > = 0 and the value > the limit; or 
if the step < @ and the value < the limit, then 
jumps to the looping line. 

Error 1 if there is no control variable @. 


PAUSE n Stops computing and displays the display file for 
n frames (at 50 frames per second) or until a key is 
pressed. d<=n<= 65535, else error B. Ifn > = 
32767, then the pause is not timed, but lasts until 
a key is pressed. 


|| 
i 
i 


PLOT m,n Blacks in the pixel (|m|,|n|); moves the PRINT position 
to just after the pixel. 
0<= |m| <=63,0<=|n|< =43, else error B. 
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Writes the value n to the byte in store with address m. 
0<=m<=65535, —- 2655<=n< = 255, else error B. 


The ‘.. .’ isa sequence of PRINT items, separated by 
commas or semicolons. They are written to the display 
file for display on the television. The position (line and 
column) where the next character is to be printed is 
called the PRINT position. 
A PRINT item can be 
(i) empty, i-e., nothing 
(ii) anumerical expression 
First, a minus sign is printed if the value is negative. 
Now let x be the modulus of the value. 
Ifx<=10-5orx> = 1013, then it is printed using 
scientific notation. The mantissa part has up to eight 
digits (with no trailing zeros), and the decimal point 
(absent if only one digit) is after the first. The expo- 
nent part is E, followed by + or — , followed by one or 
two digits. 
Otherwise x is printed in ordinary decimal notation 
with up to eight significant digits, and no trailing zeros 
after the decimal point. A decimal point right at the 
beginning is always followed by a zero, so, for instance, 
.03 and 0.3 are printed as such. 


Q is printed as a single digit 0. 

(iii) a string expression. 

The tokens in the string are expanded, possibly with 

a space before or after. 

The quote image character prints as ‘‘. Unused char- 

acters and control characters print as ?. 

(iv) ATm,n 

The PRINT position is changed to line m (counting 

He the top), column n (counting from the left). 
=|m|< = 21,0 <= |n|< =31, else error B. If 

lol 22 or 23, error 5. 

(v) TABn 


nis reduced modulo 32. Then, the PRINT position is 
moved to column n, staying on the same line unless 
this would involve backspacing, in which case it 
moves on to the next line. 

0<=n< = 256, else error B. 
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ee eee 
Result 


Asemicolon between two items leaves the PRINT 
position unchanged, so that the second item follows 
immediately after the first. A comma, on the other 
hand, moves the PRINT position on at least one place; 
and after that, as many as are necessary to leave it in 
column 0 or 16, moving to a new line if necessary. 


At the end of the PRINT statement, if it does not end 
in a semicolon or comma, a new line is started. 


é 
z 


Error 4 (out of memory) can occur with 3K or less of 
memory. 


Error 5 means that the screen is filled. 


In both cases, the cure is CONT, which will clear the 
screen and allow the program to continue. 


RAND RAND 0 


aimed 
7 
= 


RAND n Sets the system variable (called SEED) used to gener- 
ate the next value of RND. If n #0, the SEED is given 
f] the value n; ifn = 0, it is given the value of another 


system variable (called FRAMES) that counts the 
frames so far displayed on the television, and so 
should be fairly random. 


a Error B occurs if n is not in the range 0 to 65535. 


REM... No effect. ‘. . .' can be any sequence of characters 
except ENTER. 


to the line after it. 


Error 7 occurs when there is no line number on the 
stack. There is some mistake in your program; GOSUBs 
ia are not properly balanced by RETURNS. 


a RETURN Pops a line number from the GOSUB stack and jumps 


i RUN RUN 0 
RUNn CLEAR, and then GOTO n. 


[| SAVE f Records the program and variables on tape and calls 
itf. 
SAVE should not be used inside a GOSUB routine. 


Error F occurs if fis the empty string, which is not 
| allowed. 
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Function Type of Result 
operand 


SCROLL Scrolls the display file up one line, losing the top line 
and making an empty line at the bottom. 


Note that the new line is genuinely empty with just 
an ENTER character and no spaces. 


SLOW Puts the computer into compute and display mode, 
in which the display file is displayed continuously 
and computing is done during the spaces at the top 
and bottom of the picture. 


STOP Stops the program with Report 9. CONT will resume 
with the following line. 


UNPLOT m,n Like PLOT, but blanks out a pixel instead of blacking 
itin. 
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Code 


Oman oanbAWNPR & 


This is the complete T/S 1500 character set, with 
codes in decimal and hex. If one imagines the codes 
being Z80 machine code instructions, then the right- 
hand columns give the corresponding assembly lan- 
guage mnemonics. As you are probably aware, certain 
280 instructions are compounds starting with CBh or 
EDh, as shown in the right-hand columns. 


Hex 2Z80 assembler 


00 nop 
01 ld bc,NN 
02 ld (bo), a 


03 inc be 
04 incb 

05 dec b 
06 Idb,N 
07 tlca 

08 ex af,af’ 


09 add hl, bc 


-after CB -after ED 


ricb 
rice 
ricd 
rice 
rich 
ric] 
ric (hl) 
rica 
ircb 
rrcc 
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(ea Se IO) 
Code Character Hex Z8Q@assembler -after CB -after ED | 
10 wi 0A ld a,(bc) ircd 
11 " 0B dec be Irce 
12 £ oc incc ich 
13 $ OD decc rrcl | | 
14 : OE ldc,N rrc (hl) 
15 ? OF rrca mca 
16 ¢ 10 djnz DIS rb 
17 ) 11 ld de,NN tlc | 
18 > 12 Id (de),a id 
19 < 13 inc de tle 
20 = 14 incd nh 
21 + 15 decd nl 
22 - 16 idd,N 1 (hl) 
23 * 17 tla tla 
24 / 18 jr DIS rb : 
25 H 19 add hl,de Irc 
26 ' 1A Id a,(de) rd 
27 ‘ 1B dec de re 
28 i) 1C ince wh 
29 1 1D dece irl 
30 2 1E lde,N rr (hl) 
31 3 1F 1ra ra 
32 4 20 jrnz,DIS slab 
33 5 21 ld hl,NN slac 
34 6 22 id (NN),hl slad [| 
35 7 23 inc hl slae 
36 8 24 inch slah 
37 9 25 dech slal 
38 A 26 Idh,N sla (hl) t | 
39 B 27 daa slaa 
40 Cc 28 jrz,DIS stab 
41 D 29 add hl,hl srac P 
42 E ‘2A Id hl,(NN) stad t | 
43 F 2B dec hl srae 
44 G 2C incl srah 
45 H 2D dec 1 sral = 
46 I 2E ld1,N sra (hl) [| 
47 J 2F cpl saa 
48 K 30 jrnc,DIS 
49 L 31 Idsp,NN : 
50 M 32 id (NN),a 
51 N 33 inc sp 
52 Oo 34 inc (hl) 
53 P. 35 dec (hl) - 
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not used 


Z8@ assembler 


id (hl),N 
scf 
jrc,DIS 
add hl.sp 
ld a,(NN) 
dec sp 
inca 
deca 
lda,N 
ccf 
Idb,b 
Id b,c 
Idb,d 
Idb,e 
Idb,h 
Id, b,] 
1d b,(hl) 
db,a 
deb 
dce,c 
ldc,d 
ldc,e 
ldc,h 
dc,l 
Id c,(hl) 
Ildc,a 
ldd,b 
dd,c 
ddd 
dd,e 
dd,h 
Idd,l 
ld d,(hl) 
Idd,a 
de,b 
dec 
ded 
de,e 
Ide,h 
Ide,l 
Id e,(hl) 
IKde,a 
Id h,b 
Id, hc 


-after CB 


srlb 
srlc 
sild 
stle 
stth 
srll 
srl (hl) 
stla 
bit @,b 
bit ,c 
bit 0,d 
bit 0,e 
bit 0,h 
bit 0,1 
bit @,(hl) 
bit 0,a 
bit 1,b 
bit 1,c 
bit 1,d 
bit t,e 
bit 1,h 
bit 1,1 
bit 1,(h)) 
bit 1,a 
bit 2,b 
bit 2,c 
bit 2,d 
bit 2,e 
bit 2,h 
bit 2,1 
bit 2, (hl) 
bit 2,a 
bit 3,b 
bit 3,c 
bit 3,d 
bit 3,e 
bit 3,h 
bit 3,1 
bit 3, (hl) 
bit 3,a 
bit 4,b 
bit 4,c 


-after ED 


in b,(c) 
out (c),b 
sbc hl,bc 
Id (NN), be 
neg 

retn 

im 0 

dia 

in c,(c) 
out (c),c 
adc hl,be 
dbe,(NN) 


reti 


dra 

in d,(c) 
out (c),d 
sbc hl,de 
Id (NN),de 


im1 

Ida,i 
ine,(c) 
out (c),e 
adc hl,de 
Id de,(NN) 


im2 
lda,r 

in h,(c) 
out (c),h 
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Code 


Character 


not used 


cursorup = 
cursor down # 
cursor left 4 
cursor right » 
GRAPHICS 
EDIT 

ENTER 
DELETE 

Eg / Bj mode 
FUNCTION 
not used 

not used 

not used 

not used 
number 

cursor 


ES USO ee 


inverse” 
inverse 
inverse$ 


Z8@ assembler 


dh,d 
dh,e 
dh,h 
dh,l 


proeaat 


p> 
ny 
ey 
= 


BEEP 


add a,1 
add a,(hl) 
add a,a 
adc a,b 
adc a,c 
adc a,d 
adc a,e 
adc a,h 
adc a,l 


-after CB 


bit 6,(hl) 
bit 6,a 
bit 7,b 
bit 7,c 
bit 7,d 
bit 7,e 
bit 7,h 
bit 7,1 
bit 7,(hl) 
bit 7,a 
tes 0,b 
res Q,c 
res 0,d 
res @,e 
res 0,h 
res 0,1 
res @,(hl) 
res 0,a 
res 1,b 
res 1,c 
res 1,d 
res 1,e 
res 1,h 
res 1,] 


-after ED 


sbc hl,hl 
Id (NN),hl 


rrd 

in |,(c) 

out (c),1 
adc hi,hl 
Id de,(NN) 


rid 


sbc hl,sp 
ld (NN),sp 


in a,(c) 
out (c),a 
adc hl,sp 
Id sp,(NN) 
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162 


176 
177 


185 


Character 


inverse: 
inverse ? 
inverse ( 
inverse ) 
inverse > 
inverse < 
inverse = 
inverse + 
inverse — 
inverse * 
inverse / 
inverse ; 
inverse , 
inverse. 
inverse 0 
inverse 1 
inverse 2 
inverse 3 
inverse 4 
inverse 5 
inverse 6 
inverse 7 
inverse 8 
inverse 9 
inverse A 
inverse B 
inverse C 
inverse D 
inverse E 
inverse F 
inverse G 
inverse H 
inverse I 
inverse J 
inverse K 
inverse L 
inverse M 
inverse N 
inverse O 
inverse P 
inverse O 
inverse R 
inverse S 
inverse T 


280 assembler 


adc a,(hl) 
adc a,a 
sub b 
sub c 
subd 
sube 
sub h 
sub 1 

sub (hl) 
suba 
sbc a,b 
sbc a,c 
sbca,d 
sbca,e 
sbcah 
sbc al 
sbc a,(hl) 


_sbca,a 


and b 
andc 
andd 
ande 
andh 
and 1 
and (hl) 
anda 
xor b 
XOIC 
xord 
xore 
xorh 
xor | 
xor (hl) 
xora 
orb 
orc 
ord 
ore 
orh 
orl 

or (hl) 
ora 
cpb 
cpc 


-after CB 


res 1,(hl) 
res 1,a 
res 2,b 
Tes 2,c 
res 2,d 
res 2,e 
res 2,h 
Tes 2,] 
res 2, (hl) 
Tes 2,a 
tes 3,b 
Tes 3,c 
tes 3,d 
Tes 3,e 
res 3,h 
res 3,] 
res 3,(hl) 
Tes 3,a 
tes 4,b 
res 4,c 
tes 4,d 
res 4,e 
res 4,h 
tes 4] 
res 4,(hl) 
res 4,a 
res 5,b 
tes 5,c 
res 5,d 
res 5,e 
res 5,h 
tes 5,1 
res 5,(hl) 
res 5,a 
res 6,b 
res 6,c 
res 6,d 
res 6,e 
res 6,h 
res 6,1 
res 6, (hl) 
res 6,a 
tes 7,b 
res 7,c 


-after ED 


Iddr 
cpdr 
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Code Character Hex Z8@assembler_ -after CB -after ED 
86 inverse U BA cpd res 7,d indr 
87 inverse V BB cpe res 7,e otdr 

188 inverse W BC cph res 7,h 

189 inverse X BD cpl res 7,] 
90 inverse Y BE cp (hl) res 7,(hl) 

191 inverse Z BF cpa res 7a 
92 ee Co ret nz set @,b 
93 AT C1 pop be set @,c 
94 TAB C2 jp nz,NN set @,d 
95 not used C3 jp NN set Ge 
96 CODE C4 call nz,NN set @,h 

197 VAL C5 push be set 0,1 

198 LEN C6 adda,N set 0,(hl) 

199 SIN C7 rst 0 set 0,a 

200 Cos C8 ret z set 1,b 

201 TAN cg ret set T,c 

202 ASN CA ip z,NN set 1,d 

203 ACS CB set 1,6 

204 ATN . | cc call z,NN set 1,h 

205 LN CD call NN set 1,1 

206 EXP CE adc a,N set 1,(hl) 

207 INT CF rst 8 set la 

208 SOR DQ retnc set 2,b 

209 SGN D1 pop de set 2,c 

210 ABS D2 jp nc,NN set 2,d 

211 PEEK D3 out N,a set 2,e 

212 USR D4 calinc,NN set 2,h 

213 STR$ D5 push de set 2,1 

214 CHR$ D6 sub N set 2,(hl) 

215 NOT D7 rst 16 set 2,a 

216 a D8 retc set 3,b 

217 OR D9 exx set 3,c 

218 AND DA jp c,NN set 3,d 

219 = DB ina,N set 3,e 

220 = DC call c,NN set 3,h 

221 <> DD prefixes instruc- set3,] 

ions using ix 

222 THEN DE sbc a,N set 3,(hl) 

223 TO DF st 24 set 3,a 

224 STEP E@ et po set 4,b 

225 LPRINT E pop h set4c 

226 LLIST E2 jp po,NN set 4,d 

227 STOP B ex (sp),hl set 4,e 

228 SLOW E4 call po,NN set 4h 
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Z8@0 assembler -after CB 


push hl 
and N 

rst 32 

ret pe 

ip (hl) 

jp pe,NN 
ex de,hl 
call pe, NN 


xor N 

tst 40 

ret p 

pop af 

jp p,.NN 

di 

call p,NN 
push af 

orN 

rst 48 

retm 

ld sp,hl 

jp m,NN 

ei 

call m,NN 
prefixes instruc- 
tions using iy 
cpN 

rst 56 


set 4,1 
set 4, (hl) 
set 4,a 
set 5,b 
set 5,c 
set 5,d 
set 5,e 
set 5,h 
set 5,1 
set 5,(hl) 
set 5,a 
set 6,b 
set 6,c 
set 6,d 
set 6,e 
set 6,h 
set 6,1 
set 6, (hl) 
set 6,a 
set 7,b 
set 7,c 
set 7,d 
set 7,e 
set 7,h 
set 7,1 


set 7,(hl) 
set 7,a 


-after ED 
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§) Using Machine Code 


This appendix is written for those who understand Z80 
machine code, the set of instructions that the Z80 proc- 
essor chip uses. If you wish to learn more about Z80 
machine codes and programming, many books are 
available. 


The ultimate authority is the 780 Assembly Language 
Programming Manual, together with the Z80-CPU, Z80A- 
CPU Technical Manual, published by Zilog; but these 
can hardly be recommended for beginners. 


Machine code routines can be executed from within a 
BASIC program by using the function USR. The argu- 
ment of USR is the starting address of the routine, and 
its result is a two-byte unsigned integer, the contents 
of the bc register pair on return. The return address to 
the BASIC is stacked in the usual way, so return is by 
a Z80 RET instruction. 
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a 
There are certain restrictions on USR routines: 
(i) On return, the i register must have the value 1Eh. 
(ii) The display routine uses a’, f’, ix, iy andr registers, 
a USR routine should not use these if compute and 
display is operating. (It is not even safe to read the 
af’ pair.) 
All these lines from the processor are exposed at the 
back of the T/S 1500, so in principle you can do anything 
with a T/S 1500 that you can with a Z80. The T/S 1500 
hardware might sometimes get in the way, though, 
especially in compute and display. Here is a diagram 
of the exposed connections at the back: 


1B : 
UNDER | | | | | | | | | | | 23B 
SIDE 


5V 9V SLOT 0V 0 A® Al A2 A3A15 A14A13A12A11A10A9 A8 A7 AG A5 A4 ROM 
S. 


1A 23A 
TOP 
D7’ | SLOT D0’ D1’ D2’ Dé’ D5’ D3’ D4’ INT | HALT| IORO RD WR | WAIT |RESET | REFSH 


RAM NMI MREQ BUSAK BUSRQ M1 
RM 


A piece of machine code in the middle of memory 
runs the risk of being overwritten by the BASIC sys- 
tem. Some safer places are 


(i) InaREMstatement: type in a REM statement 
with enough characters to hold your machine 
code, which you then poke in. Avoid halt instruc- 
tions, since these will be recognized as the end of 
the REM statement. 

(ii) In astring: set up a long enough string, and then 
assign a machine code byte to each character. 


In both of these the code is safe, but likely to move 
about; this is especially the case with strings. In the 
Appendix, the character set, you will find the charac- 
ters and Z80 instructions written side by side in order, 
and you may well find this useful when entering code. 
(iii) At the top of the memory. When the T/S 1500 is 
switched on, it tests to see how much memory 
there is and puts the machine stack right at the 
top so that there is no space for USR routines there. 
It stores the address of the first nonexistent byte 
(e.g. 33K, or 32768, if you have 16K memory) ina 
system variable known as RAMTOP, in the two 
bytes with addresses 16388 and 16389. NEW, on 
the other hand, does not do a full memory test, 
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pe | 
but only checks up as far as just before the address 
in RAMTOP. Thus, if you poke the address of an 
existing byte into RAMTOP, for NEW all the mem- 
ory from that byte on is outside the BASIC system 
and is left alone. For instance, suppose you have 
1K memory and you have just switched on the 
computer. 


PRINT PEEK 16388 + 256 *PEEK 16389 


tells you the address (32768) of the first nonexistent 
byte. 

Now suppose you have a USR routine 20 bytes long. 
You want to change RAMTOP to 32748 =.236 + 256+*127 
(how would you work this out in the computer?), so type 


-POKE 16388 ,236 
POKE 16389, 127 


and then NEW. The twenty bytes of memory from 
address 32748 to 32768 are now yours to do with what 
you like. If you then type NEW again it will not affect 
these twenty bytes. 


The top of memory is a good place for USR routines, 
safe (even from NEW) and immobile. Its main disad- 
vantage is that it is not saved by SAVE. 
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7 pete 
| | 
, 


The memory is divided into different areas for storing 
different kinds of information. The areas are only large 
enough for the information they actually contain, and if 
you insert more at a given point (for instance, by adding 
a program line or variable), space is made by shifting 
up everything above that point. Conversely, if you 
delete information, everything above the deletion is 
shifted down. 


The operating system is contained ina ROM witha 
starting address of @ and an ending address of 8191. 


RAM memory starts at address 16384 and extends to 
32767 for your T/S 1500. 
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Byte containing 80h 


Vv 


System : : ‘ Line being typed 
ae pas as | vanabies |] Hpepetna ped 
1 - 


A A A A A 
16384 16509 D_FILE VARS E__LINE STKBOT 


A A A A 
STKBOT STKEND Machinestack ERR_SP RAMTOP 
pointer sp 


An additional 16K Ram Pack installed on the system is 
not detected by the system software. Hence, the system 
variable RAMTOP must be manually changed anda 
NEW command executed to incorporate the RAM into 
the system for use by BASIC. The following will 
incorporate the additional RAM into the system: 


POKE 16388, 0 
POKE 16389, 192 
NEW 


The user must be aware of one fact when using the 
16K RAM pack on the T/S 1500 system. When BASIC 
program lines are typed (or loaded from external device) 
into the system, the display file, i.e. what is on the 
screen at the time, moves higher into memory. If more 
text is displayed on the screen, the display file gets 
larger and moves higher into memory. The problem 

is if any part of the display file moves past 32767 into 
higher memory, system operation is impaired and may 
not function properly. 


The danger of the display file crossing the 32K 
boundary only exists while BASIC programs are being 
entered after poking RAMTOP to a value greater than 
32768. This is because the system only compares the 
amount of memory used with RAMTOP to determine 
if the system is out of memory. 


To find out how many bytes of RAM are still available 
for BASIC program lines, type this test: 


PRINT 32768 — PEEK 16400 — 256*PEEK 16401 
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TE S50 20 RI ae ES SEB ON ERR Be aS aN SSNS NIUE RSP en asa 
* You will only find it necessary if you are writing a 
very long program. 


‘The memory from 32768 to 49151 is available for vari- 
ables and machine code that resides in string variables 
or between RAMTOP and the actual top of memory. 


If you want to check your memory you can try typing 
in this test—it will show whatever memory is avail- 
able, e.g., 16K, 32K. 


MEMORY TEST PROGRAM 

1 POKE 18000, 33 

2 POKE 18001, 11 

3 POKE 18002, 0 

4 POKE 18003, 57 

5 POKE 18:04, 68 

6 POKE 18005, 77 

7 POKE 18006, 201 

8 PRINT (USR (18000) — 16373)/1024: "K” 


The system variables contain various pieces of infor- 
mation that tell the computer what sort of state the 
computer is in. They are listed fully in the next chapter, 
but for the moment note that there are some (called 
D__FILE, VARS, E__LINE and so on) that contain the 
addresses of the boundaries between the various areas 
in the memory. These are not BASIC variables, and 
their names will not be recognized by the computer. 


In the program, each line is stored as 


More significant byte 

: Less significant byte 
a ° 

Vv Vv 


FG es ee 
Linenumber Length of Text ENTER 
text + ENTER 
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BET Se OE a ST SRR ae) 
Note that, in contrast with all other cases of two-byte 
numbers in the Z80, the line number here (and also in 
a FOR-NEXT control variable) is stored with its more 
significant byte first: that is to say, in the order that 
you would write them down. 


A numerical constant in the program is followed by 
its binary form, using the character CHR$ 126 followed 
by five bytes for the number itself. 


The display file is the memory copy of the television 
picture. It begins with an ENTER character, followed 
by twenty-four lines of text, each finishing with an 
ENTER. The system is so designed that a line of text 
does not need a full thirty-two characters: final spaces 
can be omitted. This is done to save space when the 
memory is small. 


When the total amount of memory (according to the 
system variable RAMTOP) is less then 314K, a clear 
screen—as set up at the start or by CLS—consists of 
just 25 ENTERs. When the memory is bigger, a clear 
screen is padded out with 24*32 spaces, and on the 
whole it stays at its full size; SCROLL, however, and 
certain conditions where the lower part of the screen 
expands to more than two lines, can upset this by 
introducing short lines at the bottom. 


The variables have different formats, depending on 
their different natures. 


Number whose name is one letter only: 
Sign bit 


‘ ee a | 
arpa teas 


Letter Value 


Number whose name is longer than one letter: 


Ne Se 


Letter 2nd character Last character Value 
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eee 


= 


4 
3 


ee 
ae 


q 


Es 


oe oe 


a 
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_ Array of numbers: 
Neer Vereen ieee \eeiain ieee sean  naraanesainaneenatibetmasieemnieeme anmimememmmed 
Letter-20h Total No. of ist dim. Last dim. Elements 

length of dimensions 

elements & 

dimensions 
+ 1 forno. 

of dimensions 


The order of the elements is: 


first, the elements for which the first subscript is 1 
next, the elements for which the first subscript is 2 
next, the elements for which the first subscript is 3 
and so on for all possible values of the first subscript. 


The elements with a given first subscript are ordered 
in the same way using the second subscript, and so on 
down to the last. 


As an example, the elements of the 3 x 6 array B in 
Chapter 22 are stored in the order B(1,1), B(1,2), B(1,3), 
B(1,4), B(1,5), B(1,6), B(2,1), B(2,2),. . ., B(2,6), B(3,1), 
B(3,2),. . ., B(3,6). 


Control variable of a FOR-NEXT loop: 


More significant 
° 


; Less significant 
Vv Vv 


a 


Letter Value Limit Step Looping line 
String: 
_ 
Letter-20h Number of Text of string (may be empty) 
characters 


157 


Appendix D: 


Organization of Storage 


See ot |e 


Array of characters: 


ica c “* | 


Ne Neer! Ne yy a 


Letter-20h Total 
number of 
elements 
& dims. + 
1 for no. 
of dims. 
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No. of 1st dim. Last dim. Elements 
dims. 


The part starting E__LINE contains the line being 
typed (as a command, a program line, or INPUT data) 
and also some work space. 

The calculator is the part of the BASIC system that 
deals with arithmetic, and the numbers it is operating 
are held mostly in the calculator stack. 


The spare part contains the space so far unused. 
The machine stack is the stack used by the Z80 chip 
to hold return addresses and so on. 


The space for USR routines has to be set aside by you, 
using NEW as described in the Appendix on Using 
Machine Code. ws 


" Appendix E: 
y The System Variables 


le | The bytes in memory from 16384 to 16508 are set aside 
for specific uses by the system. You can peek them to 
find out various things about the system, and some of 
them can be usefully poked. They are listed here with 
their uses. 


These are called system variables and carry names, 
but do not confuse them with the variables used by the 
BASIC. You cannot use the names in a BASIC program; 
they are simply mnemonics that are used to make it 
easier to refer to the variables. 


The abbreviations in column 1 have the following 
meanings. 


X The variable should not be poked, because the 
system might crash. 

N_ Poking the variable will have no lasting effect. 

S_ The variable is saved by SAVE. 

The number in column 1 is the number of bytes in the 

variable. For two bytes, the first one is the less signifi- 

cant byte—the reverse of what you might expect. So to 

poke a value v to a two-byte variable at address n, use 
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Si SS SO NAS SUG SE SS a 
POKE n,v—256*INT(v/256) 
POKE n + 1, INT (v/256) 


and to peek its value,use the expression: 
PEEK n + 256*PEEK (n + 1) 
Notes Address Name Contents 


1 16384 ERR__NR 1 less than the report code. Starts off at 
255 (for — 1), so PEEK 16384, if it works 
at all, gives 255. POKE 16384,n can be 
used to force an error halt: 0<=n<=14: 
gives one of the usual reports, 15<=n< 
= 340r 99< =n< = 127 gives a non- 
standard report, and 35<=n<=98is 
likely to mess up the display file. 


X1 16385 FLAGS Various flags to control the BASIC 
system. 

X2 16386 ERR__SP Address of first item on machine stack 
(after GOSUB returns). 

2 16388 RAMTOP Address of first byte above BASIC sys- 


tem area. You can poke this to make NEW 
reserve space above that area or to fool 
CLS into setting up a minimal display file. 
N1 16390 MODE Specifies K, L, F or G cursor. 
N2 16391 PPC Line number of statement currently 
being executed. Poking this has no last- 
ing effect except in the last line of the 


program. 

$1 16393 VERSN 0 Identifies 8K ROM in saved programs. 

$2 16394 E__PPC Number of current line (with program 
cursor). 

SX2 16396 D__FILE See Appendix D. 

S2 16398 DF__CC Address of PRINT position in display 
file. Can be poked so that PRINT output 
is sent elsewhere. 

SX2 16400 VARS See Appendix D. 

SN2 16402 DEST Address of variable in assignment. 

SX2 16404 E__LINE See Appendix D. 

SX2 16506 CH__ADD Address of the next character to be 


interpreted: the character after the argu- 
ment of PEEK, or the ENTER at the end 


of a POKE statement. 
$2 16408 X__PTR Address of the character preceding 
the marker. 
SX2 16410 STKBOT 
+ See Appendix D. 
SX2 16412 STKEND 
SN1 16414 BREG Calculator’s b register. 
160 


Appendix E: 
'  _The System Variables 


Notes Address Name Contents 
[| SN2 16415 MEM Address of area used for calculator's 
aaa memory. (Usually MEMBOT, but not 
always.) 
S1 16417 not used 
SX1 16418 DF__SZ The number of lines (including one blank 
line) in the lower part of the screen. 
i S2 16419 S__TOP The number of the top program line in 
automatic listings. 
SN2 16421 LAST__K Shows which keys pressed. 
] SN1 16423 Debounce status of keyboard. 
nae SN1 16424 MARGIN Number of blank lines above or below 
picture—31. 
SX2 16425 NXTLIN Address of next program line to be 
executed. 
f S2 16427 OLDPPC Line number to which CONT jumps. 
ane SN1 16429 FLAGX Various flags. 
SN2 16430 STRLEN Length of string type designation in 
assignment. 
SN2 16432 T-ADDR Address of next item in syntax table 
(very unlikely to be useful). 
82 16434 SEED The seed for RND. This is the variable 
that is set by RAND. 
$2 16436 FRAMES Counts the frames displayed on the 
television. Bit 15 is 1. Bits @ to 14 are 
se decremented for each frame sent to the 


television. This can be used for timing, 
but PAUSE also uses it. PAUSE resets bit 
15 to @ and puts in bits 0 to 14 the length 
of the pause. When these have been 
- counted down to zero, the pause stops. If 
the pause stops because of a key depres- 


sion, bit 15 is set to one again. 
[| S1 16438 COORDS x-coordinate of last point PLOTted. 
$1 16439 y-coordinate of the last point PLOTted. 
S1 16440 PR__CC Less significant byte of address of next 
position for LPRINT to print at (in 
PRBUFF). 
SX1 16441 S__POSN Column number for PRINT position. 
tis 8X1 16442 Line number for PRINT position. 
$1 16443 CDFLAG Various flags. Bit 7 is on (1) during com- 
pute and display. 
$33 16444 PRBUFF Printer buffer (33rd character) is ENTER. 
Ned SN3O 16477 MEMBOT _ Calculator’s memory area; used to store 


numbers that cannot conveniently be 
put on the calculator stack. 


| $2 16507 not used 
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Appendix F: Keyword 
Reference Table 


How To Obtain 


Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

SHIFT Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Need K cursor, then press the Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Need K cursor, then press the Primary Key 
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FAST 
FOR 


FUNC- 
TION 


GOSUB 
GOTO 
GRAPH- 


Ics 


IF 
IN KEY$ 


INPUT 
INT 


LEN 


LET 
LIST 
LLIST 
LN 


LOAD 
LPRINT 
NEW 
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Pu e 


Need K cursor, then press the Primary Key 


Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 


Need K cursor, then press the Primary Key 

Need K cursor, then press the Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

SHIFT Primary Key 

Need K cursor, then press the Primary Key 
SHIFT Primary Key 


‘Primary Key 


Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

SHIFT Primary Key 

Need K cursor, then press the Primary Key 


SHIFT Primary Key 
Need K cursor, then press the Primary Key 
Need K cursor, then press the Primary Key 


SHIFT Primary Key 
Need K cursor, then press the Primary Key 
Need F cursor (SHIFT ENTER Key), then press the 


‘Primary Key 


Need K cursor, then press the Primary Key 


Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 


Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 


Need K cursor, then press the Primary Key 

Need K cursor, then press the Primary Key 
SHIFT Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Need K cursor, then press the Primary Key 

SHIFT Primary Key 

Need K cursor, then press the Primary Key 
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PRINT 
RAND 
REM 
RETURN 
RND 


RUN 
SAVE 
SCROLL 
SGN 


SHIFT 
KEY 
SIN 


SLOW 
SPACE 
SOR 


STEP 
STOP 
STR$ 


TAB 


TAN 


THEN 


2a 


HiHHivoo ozs 


"ow wm a 


Need K cursor, then press the Primary Key 


Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 


SHIFT Primary Key 

Need K cursor, then press the Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Need K cursor, then press the Primary Key 

Need K cursor, then press the Primary Key 

Need K cursor, then press the Primary Key 

Need K cursor, then press the Primary Key 

Need K cursor, then press the Primary Key 

Need K cursor, then press the Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Need K cursor, then press the Primary Key 

Need K cursor, then press the Primary Key 

Need K cursor, then press the Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Primary Key 


Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

SHIFT Primary Key 

Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

SHIFT Primary Key 

SHIFT Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 

SHIFT Primary Key 
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a ae 
Tokens Primary | How To Obtain 


(Key Key 
Words & Name 
Functions) 
TO 4 , SHIFT Primary Key 
USR L Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 
VAL J Need F cursor (SHIFT ENTER Key), then press the 
Primary Key 
= J SHIFT Primary Key 
>= Y SHIFT Primary Key 
<= R SHIFT Primary Key 
" P SHIFT Primary Key 
$ U SHIFT Primary Key 
¢ I SHIFT Primary Key 
) e) SHIFT Primary Key 
* B SHIFT Primary Key 
kk H SHIFT Primary Key 
+ K SHIFT Primary Key 
; . SHIFT Primary Key 
/ Vv SHIFT Primary Key 
: Z SHIFT Primary Key 
: x SHIFT Primary Key 
= L SHIFT Primary Key 
? c SHIFT Primary Key 
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" Index 


A 

ABS. 

accuracy 

ACS 

AND 

array 

array variable name 
arrows 

ASN 

assign 

assignment statement 
AT 

ATN 


B 

BASIC 

branch 

branching program 


31 


69 


167 


168 


cables 
call 
cassette recorder 
CHRS 
CLEAR 
CLS 
CODE 
code 
machine code 
comma 
command 
comparison 
—of numbers 
—of strings 
compute & display 
CONT 
control 
—variable 
COPY 
cos 
counter 
current line 
cursor 
cursor 
cursor 
Eg cursor 
cursor 
program cursor ( § ) 
CUurSOr arrows 


D 
DELETE 
DIM 
dimension 
display file 
down arrow 


25, 42, 124, 130 
126 


6 

90 

6 

102, 132 

59, 135 

58, 135 

102, 103, 132 


41, 47 
18, 129 


14 

114, 135 
114 

154 

49 


zz 


E 

E (exponent) 
EAR 

EDIT 
element 


empty string 


endless loop 

ENTER 

execute 

EXP 

exponent 

expression 
numeric expression 
string expression 


F 

cursor 

FAST 

fast mode 

FOR 

FOR/NEXT loop 

FUNCTION 

function 
—mode 


G 

[ej cursor 

GOSUB 
—stack 

GOTO 

graphics 
—symbol 
—mode 

GRAPHICS 


hex (hexadecimal) 


I 

IF 

immediate mode . 
INKEYS 

INPUT 


17 

110, 135 
128 

64, 135 
64, 74, 130 
17, 36 

36, 85 

17, 51, 129 


16 

90, 136 
164 

41, 60, 136 


16, 100 
36, 129 
16 


141 


70, 73, 74, 136 
39 

108, 132 

‘70, 98, 136 
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INT 86, 132 
integer 86 
interference, 

TV picture 9 
inverse characters 16 
item 

PRINT item 138 
K 
Eg cursor 9,13 
keyboard 11 
keyword 

—mode 128 
L 
i cursor 13, 14 
left arrow 18 
LEN 182 
LET 57, 73, 136 
lettermode 128 
line 

—number 40, 41 

program line 40 
LIST 65, 136 
LLIST 122, 136 
LN 132 
‘LOAD 22, 137 
loop 63 
LPRINT 122, 137 
M 
machine code 149 
main program 90 
mantissa 130 
MIC 9 
mode 

compute & display 128 

fast mode 128 

function mode ( J ) 17, 51, 129 

graphics mode (fj ) 36, 129 

keyword mode ( fg) 128 

letter mode ( f) 128 
module : 91 
modulo 138 
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name 
—of a program 
—of a variable 
nesting 


—arrays 
—expression 
—variable names 


O 


OR 


P 

parentheses 

PAUSE 

PEEK 

PI 

pixel 

PLOT 

POKE 

position 
PRINT position 

power 
—supply 

PRINT 
—item 
—position 

printer 

priority 

processor. 

Procrustean 
assignment 

program 
—cursor 
—line 
—listing 

prompt 

pseudorandom 


40, 59, 137 
64, 137 
76, 132 
111 


130 


134 
130 


76, 133 


83 
109, 137 
127, 133, 151 


97, 137 
127, 138, 151 


48 
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172 


RAM 
RAM Pack (16K) 
RAMTOP 
RAND 
random 
relation 
—logical 
REM 
report 
RET 
RETURN 
right arrow 
RND 
ROM 
rounding 
RUN 


SAVE 
scientific notation 
SCROLL 
searching 
semicolon 
SGN 
shift 
significant digits 
simple variable 
SIN 
slicing, string 
SLOW 
SOR 
stack 
calculator stack 
GOSUB stack 
machine stack 
STEP 


153 

154 

151, 154 

87, 139 

86 

76 

76 

27, 44, 51, 139 


28, 139 


117, 118, 131 
110, 140 
85, 133 


154 
154 
154 
65, 135 


\ 


® 


2. oe | 


ES Ga 


STOP 
string 
—arrays 
—expression 
—slicing 
—variable 
STRS 
structured 
programming 
subroutine 
subscript 
substring 
superscripts 
symbol 
—graphics symbol 
syntax error marker 


(i) 


system variable 


T 
TAB 
TAN 
tape 
—counter 
—recorder 
—storage 
television 
—channel selection 
THEN 


TO 


token 
transfer switch box 
true 


U 

UHF/VHF matching 
transformer 

UNPLOT 

up arrow 

USR 


42,71, 140 
34, 75, 130 
116, 131 

134 

117, 118, 131 
58 

133 


91 

90 

130 

118, 131 
82 


16, 100 
18, 35, 129 


155, 159 


6,9, 21 

21 

70, 136 
63, 64, 135 
128 


6 
73 


8 


98, 140 
49 
133, 149 
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TS 
V 


VAL 183 

value 58 

variable 57 
control variable 64 
simple variable 115 
string variable 58 
subscripted variable 114 
system variable 155, 159 
variable name 58 


x 


x/y axes 99 


AVAAV EH Ee 1 FAY AN 
it U * 
~~ ioe) 
od ND 


Vv 
aw) 
ad 
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Report Codes 


Situations 


Any 


NEXT 


Any 


This table gives each report code, with a general 
description and a list of the statements and functions 
in which it can occur. 


Successful completion, or jump to line number bigger 
than any existing. A report with code 0 does not change 
the line number used by CONT. 


The control variable does not exist (has not been set 
up by a FOR statement), but there is an ordinary 
variable with the same name. 


An undefined variable has been used. 
For a simple variable this will happen if the variable is 
used before it has been assigned to in a LET statement. 


For a subscripted variable it will happen if the vari- 
able is used before it has been dimensioned in a DIM 
statement. 

For a control variable in a FOR statement and if there 
is no ordinary simple variable with the same name. 
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Code 
3 
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Situations 


Subscripted 
variables 


LET, INPUT, DIM, 
PRINT, LIST, 
PLOT, UNPLOT, 
FOR, GOSUB. 
Sometimes dur- 
ing function 
evaluation. 


PRINT, LIST, 
PLOT, UNPLOT 


Any arithmetic 


RETURN 
INPUT 


STOP 


SOR, LN, ASN, 
ACS 


RUN, RAND, 
POKE, DIM, 
GOTO, GOSUB, 
LIST, PAUSE, 
PLOT, UNPLOT, 
CHR$, PEEK, USR 


Array access 


VAL 


At the end of 
any statement, 
or in LOAD, 
SAVE, LPRINT, 
LLIST, or COPY. 


INPUT 


SAVE 


Meaning 

Subscript out of range. 

If the subscript is out of range (negative, or bigger 
than 65535), error B will result. 

Not enough room in memory. Note that the line num- 
ber in the report (after the /) may not be complete on 


the screen, because of the shortage of memory: for 
instance, 4/20 may appear as 4/2. See Chapter 9. 


No more room on the screen. CONT will make room 
by clearing the screen. 


Arithmetic overflow: calculations have led to a number 
great than about 1038. 


No corresponding GOSUB for a RETURN statement. 
You have attempted an INPUT command (not allowed). 


STOP statement executed. CONT will not try to 
reexecute the STOP statement. 


Invalid argument to certain functions. 
Integer out of range. When an integer is required, the 


floating-point argument is rounded to the nearest in- 
teger. If this is outside a suitable range, error B results. 


For array access, see also Report 3. 


The text of the (string) argument of VAL does not form 
a valid numerical expression. 


(i) | Program interrupted by BREAK. 


(ii) The INPUT line starts with STOP. 
Not used 


The program name provided is the empty string. 
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Notes 


: Notes 


Notes 


F Notes 


Notes 


: Notes 
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CUT ALONG DOTTED LINE 


| Join The Club 


Get the Most out of Your 
Timex Sinclair 


Join the Timex Computer Club! 


The Timex Computer Club is an exclusive group of Timex Sinclair Computer 
Owners. As a member, you will receive early notices and up-dates of Timex 
Computer Corporation technological advances, new hardware and software 
products, creative programming ideas and special offers. You will also be 
able to share computer ideas and achievements with other club members 


all over the country! 


To enroll in the Timex Computer Club, simply answer the questions below 
and return this card promptly. Your answers will assist us in developing the 
kinds of products and services which will best serve your needs. 


We welcome you and are looking forward to hearing from you. 


1. 1 Mr. 2 Mrs. 3 Ms. 4 Miss 
First Name Initial Last Name 
Street Apt. No. 
Py | | | | | State Zip 
2. Date of Purchase: | | |_| | | | 
Mo. Day Yr. 
Date of Birth: 
of person listed ie 11% 
above Mo. Yr. 
3. Where purchased? 
Received as Gift Catalog Showroom Radio-TV- 
L] Department Store Computer Store Electronic Store 
Discount Store Camera Store Mail Order 
Drug Store Other 
4. Is this the first personal computer you have owned? Yes No 
5. Howwill you use your computer? 
Household Entertainment Become Familiar 
_] Education Word Processing with Computers 
Business Learn to Program Other 


PLACE 
FIRST-CLASS 


STAMP 
HERE 


Timex Product Service Center 
P.O. Box K 

7004 Murray Street 

Little Rock, AR 72203 


~~ FOLD HERE “~ 


6. Where did you learn about your Timex computer product? 


TV Advertising Advertising in Store Salesperson 
Magazine From School Other 
Newspaper Friend 

7. Which three factors most influenced you to buy your Timex computer product? 
Price Advanced Technology Special Features 
Ease of Use Power/Capabilities Other 
Size Timex Reputation 

8. | Whatis the highest level of education you have completed? 

J Grade 8 or less 1-3 Years of College Attended or Completed 
Grade 9-11 Graduated College Graduate School 
Graduated High School 

9. Which group describes your annual family income? 

CJ] Under $10,000 $20,000-$24,999 $35,000-$49,999 
$10,000-$14,999 $25,000-$34,999 $50,000 and over 
$15,000-$19,999 

10. Do you have children at home? Yes LC) No 


If you have: comments or suggestions about our product, please write to: 


TIMEX CONSUMER SERVICE DEPARTMENT 
P.O. Box 2655 
Waterbury, CT 06725 


338-879001 


TIMEX Timex Computer Corporation Waterbury, Connecticut 06720 


